MCP Server (Mortgage Comparison Platform)

MCP Mortgage Server

MISMO 規格を使用して住宅ローン関連書類（Loan Estimates と Closing Disclosures）を解析・分析する、Model Context Protocol（MCP）サーバーです。

---

🎯 これは何ですか？

これは、AI アシスタント（Claude Desktop、OpenAI Agents など）が住宅ローン関連書類を解析・分析できるようにする Model Context Protocol（MCP）サーバーです。Loan Estimates（LE）と Closing Disclosures（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

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

Closing Disclosure の PDF を MISMO 準拠の JSON に解析します。

parse_loan_estimate と同様ですが、最終的な決済書類を対象とします。

4. compare_le_cd

Loan Estimate と Closing Disclosure を比較し、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 Loan Estimate スキーマ
• mortgage://schemas/mismo-cd - MISMO 3.4 Closing Disclosure スキーマ
• 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 Specification - 公式プロトコル仕様
• 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）
• 4 つのツール：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日