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. 确保与外部服务的网络连接正常