MCP Mortgage Server

MCP抵押服务器

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

](https://github.com/confersolutions/mcp-mortgage-server/releases)   

______________________________________________________________________

🎯 这是什么？

这是一个 模型上下文协议（MCP）服务器 它允许AI助手（如Claude Desktop、OpenAI Agents等）解析和分析抵押文件。它将贷款估算（LE）和交割披露（CD）转换为结构化的符合MISMO的JSON，并检查是否违反TRID。

主要特点

✅ 符合MCP标准 -与Claude Desktop、OpenAI代理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

1. 安装依赖项:

   pip install -r requirements.txt

1. 测试服务器:

   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 - 视窗: %APPDATA%\Claude\claude_desktop_config.json - Linux: ~/.config/Claude/claude_desktop_config.json

1. 添加此服务器:

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

1. 重新启动克劳德桌面

1. 在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大小限制，30秒超时。

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 -相同的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检查员进行测试

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 -分步说明
• 看 现代化_苏迈.md -变化分析

关键变化:

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

______________________________________________________________________

📖 文档

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

______________________________________________________________________

🤝 贡献

我们欢迎捐款！看 贡献.md 作为指导方针。

______________________________________________________________________

📄 许可证

MIT许可证-请参阅 许可证 文件以获取详细信息。

______________________________________________________________________

🏢 关于

由...维护 Confer解决方案

联系: info@confersolutions.ai

______________________________________________________________________

⭐ 更新日志

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

重大重写：按照MCP规范2025-03-26完成建筑现代化。

添加:

• MCP协议支持（JSON-RPC 2.0通过stdio）
• 四种工具：hello、parse_loan_estimate、parse_closing_disclosure、compare_le_cd
• 资源：MISMO模式、抵押贷款术语表
• 提示：分析_预估
• 安全性：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+。

______________________________________________________________________

状态: ✅ 积极发展|🏗️ 测试版|📦 生产就绪核心

最后更新：2025年11月16日