<中文翻译> MCP抵押服务器

Name: MCP抵押服务器
Author: confersolutions

作者：confersolutions2 星标更新：2025-11-17

安装使用来源：spider==github.com

项目介绍

MCP 抵押贷款服务器

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

🎯 这是什么？

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

主要特性

✅ MCP兼容 - 原生支持Claude Desktop、OpenAI代理SDK和其他MCP客户端 ✅ 安全 - URL验证、防止SSRF攻击、文件大小限制、超时保护 ✅ 类型安全 - 使用Pydantic模型确保数据验证 ✅ TRID合规性 - 自动容差检查（零容差、10%容差） ✅ 资源 - 访问MISMO模式和抵押贷款词汇表 ✅ 提示 - 预建的工作流用于贷款分析

🚀 快速开始

先决条件

Python 3.10或更高版本
推荐使用Claude Desktop或其他MCP兼容客户端

安装

克隆仓库：

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

安装依赖项：
```
pip install -r requirements.txt
```

测试服务器：

python test_server.py

您应该看到：

✓ 所有测试通过！
服务器已准备好接受MCP客户端连接！

使用Claude Desktop

找到您的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

添加此服务器：

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

重启Claude Desktop

在Claude中使用它：

你能解析这个贷款估算并总结关键条款吗？
URL: https://storage.googleapis.com/mortgage-docs/sample-le.pdf

Claude会自动调用适当的MCP工具并解析文档。

🛠️ 可用工具

1. `hello`

简单的连通性测试。

输入: { "name": "World" }
输出: "Hello, World! MCP服务器工作正常。"

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增加了$100.00"
    }
  ],
  "summary": "✗ 不合规：发现1个违规"
}

📚 资源

服务器提供只读资源：

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环境变量。

🧪 开发

运行测试

# 快速测试套件
python test_server.py

# 完整的pytest套件
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

联系：info@confersolutions.ai

⭐ 更新日志

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+。

状态：✅ 活跃开发 | 🏗️ 测试版 | 📦 生产就绪核心

最后更新：2025年11月16日