MCP Server (Mortgage Comparison Platform)

MCP Mortgage Server

用于按照 MISMO 标准解析和分析抵押贷款文件（贷款估算书和结算披露文件）的模型上下文协议（MCP）服务。

---

🎯 这是什么？

这是一个模型上下文协议（MCP）服务，可让 AI 助手（如 Claude Desktop、OpenAI Agents 等）解析和分析抵押贷款文件。它会将贷款估算书（LE）和结算披露文件（CD）转换为符合 MISMO 标准的结构化 JSON，并检查 TRID 合规性违规情况。

主要功能

✅ 符合 MCP 标准 - 可原生搭配 Claude Desktop、OpenAI Agents SDK 和其他 MCP 客户端使用 ✅ 安全 - URL 验证、防止 SSRF、文件大小限制和超时保护 ✅ 类型安全 - Pydantic 模型确保数据经过验证 ✅ TRID 合规性 - 自动检查容差（零容差、10% 容差） ✅ 资源 - 可访问 MISMO 架构和抵押贷款术语表 ✅ 提示词 - 为贷款分析预设的工作流

---

🚀 快速开始

前置条件

• Python 3.10 或更高版本
• Claude Desktop（推荐）或其他兼容 MCP 的客户端

安装

1. 克隆代码库：

   git clone https://github.com/confersolutions/mcp-mortgage-server.git
   cd mcp-mortgage-server
   

2. 安装依赖项：

   pip install -r requirements.txt
   

3. 测试服务：

   python test_server.py
   

   你应该会看到：

   ✓ All tests passed!
   Server is ready for MCP client connections!
   

在 Claude Desktop 中使用

1. 找到 Claude Desktop 配置文件：

   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%\Claude\claude_desktop_config.json
   • Linux：~/.config/Claude/claude_desktop_config.json

2. 添加此服务：

   {
     "mcpServers": {
       "mortgage": {
         "command": "python",
         "args": ["/full/path/to/mcp-mortgage-server/server.py"]
       }
     }
   }
   

3. 重启 Claude Desktop

4. 在 Claude 中使用：

   Can you parse this loan estimate and summarize the key terms?
   URL: https://storage.googleapis.com/mortgage-docs/sample-le.pdf
   

   Claude 会自动调用相应的 MCP 工具并解析文件。

---

🛠️ 可用工具

1. hello

简单的连接测试。

Input: { "name": "World" }
Output: "Hello, World! MCP server is working correctly."

2. parse_loan_estimate

将贷款估算书 PDF 解析为符合 MISMO 标准的 JSON。

输入：

{
  "pdf_url": "https://storage.googleapis.com/mortgage-docs/le-12345.pdf"
}

输出：

{
  "loan_amount": 300000.0,
  "interest_rate": 6.5,
  "apr": 6.73,
  "monthly_payment": 1896.20,
  "total_closing_costs": 12000.00,
  "origination_charges": 1500.00,
  ...
}

安全性：仅允许使用白名单域名中的 HTTPS URL。文件大小上限为 10MB，超时时间为 30s。

3. parse_closing_disclosure

将结算披露文件 PDF 解析为符合 MISMO 标准的 JSON。

与 parse_loan_estimate 类似，但用于最终结算文件。

4. compare_le_cd

比较贷款估算书与结算披露文件，以检查 TRID 合规性。

输入：

{
  "loan_estimate_url": "https://storage.googleapis.com/docs/le.pdf",
  "closing_disclosure_url": "https://storage.googleapis.com/docs/cd.pdf"
}

输出：

{
  "is_compliant": false,
  "violations": [
    {
      "type": "zero_tolerance",
      "fee": "Origination Charges",
      "le_amount": 1500.00,
      "cd_amount": 1600.00,
      "amount_over": 100.00,
      "description": "Origination Charges increased by $100.00"
    }
  ],
  "summary": "✗ NOT COMPLIANT: 1 violation(s) found"
}

---

📚 资源

服务提供只读资源：

• mortgage://schemas/mismo-le - MISMO 3.4 贷款估算书架构
• mortgage://schemas/mismo-cd - MISMO 3.4 结算披露文件架构
• mortgage://glossary/terms - 抵押贷款术语定义

---

💡 提示词

预设工作流：

analyze_loan_estimate

参数：{ "analysis_type": "comprehensive" }

类型：quick、comprehensive、compliance

---

🔒 安全性

内置保护措施

• ✅ 仅限 HTTPS - 拒绝 HTTP URL
• ✅ 域名白名单 - 仅允许使用经批准的存储域名（防止 SSRF 攻击）
• ✅ 文件大小限制 - 最大 10MB
• ✅ 超时保护 - 下载超时时间为 30 秒
• ✅ PDF 验证 - 检查魔数
• ✅ 类型安全 - 使用 Pydantic 验证所有输入和输出

允许的域名

默认情况下：

• storage.googleapis.com
• s3.amazonaws.com
• mortgage-docs.confer.ai

如需添加域名，请设置 ALLOWED_DOMAINS 环境变量。

---

🧪 开发

运行测试

# Quick test suite
python test_server.py

# Full pytest suite
pytest tests/ -v

使用 MCP Inspector 测试

npm install -g @modelcontextprotocol/inspector
npx @modelcontextprotocol/inspector python server.py

---

📈 路线图

✅ v2.0.0（当前版本）

• 现代 MCP 协议实现
• 使用存根数据的基础工具定义
• 安全控制
• 资源和提示词
• 类型安全的数据模型

🚧 v2.1.0（进行中）

• 实际 PDF 解析（由 AI 驱动或使用 PyMuPDF）
• 全面的测试套件
• 性能优化

🔮 v2.2.0（计划中）

• 流式传输支持
• 进度通知
• 后台任务队列
• 其他抵押贷款分析工具

---

🔄 从 v0.1.0 迁移

如果要从旧版 REST API 升级：

• 请参阅 MIGRATION_GUIDE.md - 分步说明
• 请参阅 MODERNIZATION_SUMMARY.md - 变更分析

主要变更：

• ❌ 移除了 FastAPI/HTTP REST API
• ✅ 添加了 MCP 协议（通过 stdio 使用 JSON-RPC 2.0）
• ✅ 移除了 API 密钥身份验证
• ✅ 添加了类型安全的工具定义
• ✅ 添加了资源和提示词

---

📖 文档

• MCP 规范 - 官方协议规范
• MIGRATION_GUIDE.md - 详细的迁移说明
• MODERNIZATION_SUMMARY.md - 现代化分析

---

🤝 贡献

欢迎贡献！请参阅 CONTRIBUTING.md 了解指南。

---

📄 许可证

MIT 许可证 - 详情请参阅 LICENSE 文件。

---

🏢 关于

由 Confer Solutions 维护

联系方式：[email protected]

---

⭐ 更新日志

v2.0.0（2025-11-16）- 现代 MCP 协议

重大改写：根据 MCP 规范 2025-03-26 对架构进行了全面现代化改造。

新增：

• MCP 协议支持（通过 stdio 使用 JSON-RPC 2.0）
• 四种工具：hello、parse_loan_estimate、parse_closing_disclosure、compare_le_cd
• 资源：MISMO 架构、抵押贷款术语表
• 提示词：analyze_loan_estimate
• 安全性：URL 验证、SSRF 防护、大小限制
• 类型安全：Pydantic 模型

移除：

• FastAPI/HTTP REST API
• API 密钥身份验证
• 速率限制
• 静态 JSON 配置

变更：

• 服务端：FastAPI → 官方 MCP SDK
• 传输方式：HTTP → stdio
• 依赖项：15+ → 6 个核心包

v0.1.0（2024-04-12）- 初始版本

已弃用：REST API 版本。请使用 v2.0.0+。

---

状态：✅ 积极开发 | 🏗️ Beta 版 | 📦 核心功能已可用于生产环境

最后更新：2025 年 11 月 16 日