MCP Mortgage Server

🚀 不動産比較プラットフォーム (Mortgage Comparison Platform) サーバー

このサーバーはFastAPIベースで、標準APIを通じて住宅ローン文書の解析と比較ツールを提供します。また、CrewAI、AutoGen、LangChainなどの様々なAIフレームワークとの統合が容易に行えるよう設計されています。

現在は簡単な「こんにちは」ツールが概念実証として実装されており、次期バージョンで住宅ローン文書解析機能が追加されます。

🚀 クイックスタート

1. リポジトリをクローンします：

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

✨ 主な機能

• 本番環境で使用可能な機能を備えたFastAPIサーバー：
  • APIキーによる認証
  • レート制限のサポート
  • CORSミドルウェアの設定
• AIエージェントフレームワークとの統合：
  • CrewAI
  • AutoGen
  • LangChain
• 住宅ローン解析ツールを追加するための拡張可能なアーキテクチャ
• 透明度とコミュニティ貢献を目的としたオープンソース

📦 インストール

1. リポジトリをローカルにクローンします：

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

2. 仮想環境を作成し、依存関係をインストールします：

   python -m venv venv
   source venv/bin/activate  # Windowsの場合は `venv\Scripts\activate` を使用
   pip install -r requirements.txt
   

3. 環境変数を設定します。.env ファイルを編集します：

   API_KEY=your_api_key_here
   RATE_LIMIT_PER_MINUTE=120
   ALLOWED_ORIGINS=http://localhost:3000,http://localhost:8000
   

4. サーバーを起動します：

   uvicorn main:app --reload
   

💻 使用例

基本的な使用法

サーバーを起動すると、http://localhost:8000 で利用できます。

高度な使用法

CrewAI との統合

main.py に以下のコードを追加します：

from crewai import Crew
crew = Crew("your_api_key")
@app.get("/generate")
async def generate(context: str):
    return await crew.generate(context)

AutoGen との統合

main.py に以下のコードを追加します：

from autogen import Agent
agent = Agent()
@app.get("/analyze")
async def analyze(text: str):
    return agent.analyze(text)

🔧 技術詳細

状態

これはテスト版（v0.1.0）で、以下の機能を提供します：

• セキュリティ機能を備えたコアサーバーインフラストラクチャ
• CrewAI、AutoGen、LangChainとのフレームワーク統合の例
• フレームワーク統合をテストするための基本的な「こんにちは」ツール

次期バージョンでは住宅ローン文書の解析と比較ツールが追加されます。

レート制限

サーバーは slowapi を使用してレート制限を実装しており、デフォルトでは1分間に120回のリクエスト/IPに制限されています。RATE_LIMIT_PER_MINUTE 環境変数で設定を変更できます。

セキュリティ

• /health を除くすべてのエンドポイントはAPIキーによる認証が必要です。
• CORS設定により、特定のオリジン（ALLOWED_ORIGINS 環境変数で設定）が許可されています。
• すべての例外はキャッチされ、適切なエラーメッセージが返されます。

📚 ドキュメント

APIエンドポイント

/health

• メソッド: GET
• 説明: サーバーの状態を確認します。
• レスポンス: { "status": "ok" }

/hello/{name}

• メソッド: GET
• 説明: 挨拶メッセージを返します。
• パスパラメータ: name (文字列)
• レスポンス例: "Hello, World!"

ロードマップ

• ✅ セキュリティとレート制限を備えたコアサーバーインフラストラクチャ
• ✅ CrewAI、AutoGen、LangChainとのフレームワーク統合
• ✅ 基本的なツールの実装（「こんにちは」エンドポイント）
• 🚧 住宅ローン見積もり (LE) をMISMO形式に解析
• 🚧 不動産比較ツールの開発

🤝 貢献

問題の報告やコードの改善提案は大歓迎です。

📌 概要

このプロジェクトは Confer Solutions によってメンテナンスされています。ヘルプやサポートが必要な場合は、info@confersolutions.ai までご連絡ください。

📄 ライセンス

MITライセンス - 詳細は LICENSE ファイルを参照してください。