贷款申请MCP服务器

一个基于Spring AI MCP构建的贷款申请服务集成工具,提供贷款申请、信用评估、风险分析和抵押品管理等功能。

  • by rjtmahinay
  • Java
  • 本地部署
  • 更新于
在 GitHub 查看 rjtmahinay/loan-application-mcp-server

使用说明

贷款申请MCP服务器

这是一个使用Spring AI MCP构建的模型上下文协议(MCP)服务器,它提供了与贷款申请服务集成的工具。

特点/特性

MCP服务器为四个主要服务领域提供了工具:

1. 贷款服务

  • 创建贷款申请创建一个新的贷款申请
  • 获取贷款申请通过ID检索贷款申请
  • 更新贷款状态更新贷款申请的状态
  • 列出贷款申请列出所有贷款申请,并可选择性过滤
  • 计算贷款资格根据收入和申请金额计算贷款资格

2. 信用局服务

  • 获取信用评分为申请人获取信用评分
  • 获取信用报告获取申请人的详细信用报告
  • 验证身份验证申请人的身份
  • 检查欺诈警报检查社会保险号(SSN)的欺诈警报

3. 风险引擎服务

  • 评估风险评估贷款申请的风险
  • 计算风险评分根据财务数据计算风险评分
  • 分析欺诈风险为申请人分析欺诈风险

4. 抵押服务

  • 添加抵押品为贷款添加抵押品
  • 获取抵押品通过ID获取抵押品信息
  • 评估抵押品评估抵押品
  • 验证所有权验证抵押物的所有权

服务端点

服务器与以下外部服务集成:

  • 贷款服务: https://loan-service-git-rjtmahinay-dev.apps.rm1.0a51.p1.openshiftapps.com
  • 信用局服务: https://credit-bureau-service-git-rjtmahinay-dev.apps.rm1.0a51.p1.openshiftapps.com
  • 风险引擎服务: https://internal-risk-engine-service-git-rjtmahinay-dev.apps.rm1.0a51.p1.openshiftapps.com
  • 抵押服务: https://collateral-service-git-rjtmahinay-dev.apps.rm1.0a51.p1.openshiftapps.com

先决条件

  • Java 17 或更高版本
  • Maven 3.6 或更高版本

运行服务器

  1. 克隆仓库
  2. 导航到项目目录
  3. 运行以下命令:
./mvnw spring-boot:run

服务器将在8080端口启动。

配置

服务器可以通过(某种方式)进行配置 application.properties:

# MCP Server Configuration
server.port=8080
spring.application.name=loan-application-mcp-server

# MCP Server WebFlux Configuration
spring.ai.mcp.server.name=loan-application-mcp-server
spring.ai.mcp.server.version=1.0.0
spring.ai.mcp.server.description=MCP Server for Loan Application Services

错误处理

服务器具备优雅的错误处理机制。当外部服务不可用时,工具将返回描述性的错误消息,指出服务暂时不可用,并附上尝试请求的参数。

项目结构

src/
├── main/
│   ├── java/com/rjtmahinay/mcp/
│   │   ├── LoanApplicationMcpServerApplication.java
│   │   ├── config/
│   │   │   └── McpServerConfig.java
│   │   ├── controller/
│   │   │   └── McpServerController.java
│   │   └── tools/
│   │       ├── LoanServiceTools.java
│   │       ├── CreditBureauServiceTools.java
│   │       ├── RiskEngineServiceTools.java
│   │       └── CollateralServiceTools.java
│   └── resources/
│       └── application.properties

依赖项

该项目使用Spring AI MCP,并包含以下关键依赖项:

  • Spring Boot 3.5.6
  • Spring AI MCP 服务器 WebFlux 启动器
  • Spring WebFlux
  • 反应堆堆芯

与MCP客户端的使用

此服务器可与任何兼容MCP(模型上下文协议)的客户端配合使用。服务器通过模型上下文协议提供工具,使AI助手和其他应用程序能够与贷款申请服务进行交互。

发展

添加新工具或修改现有工具:

  1. 创建或修改服务类 tools/ 包裹;软件包
  2. 更新 McpServerController 展示新功能
  3. 重启服务器

故障排除

如果您遇到问题:

  1. 检查所有外部服务是否可访问
  2. 验证服务器是否在预期端口上运行
  3. 检查日志以获取详细的错误信息
  4. 确保与外部服务的网络连接正常