MCP Mortgage Server

🚀 房地產比較平臺 (Mortgage Comparison Platform) 服務器

本服務器基於 FastAPI 構建，藉助標準 API 提供抵押貸款文檔解析與比較工具。它能夠輕鬆與各類人工智能框架（如 CrewAI、AutoGen 和 LangChain）集成。當前已實現一個簡單的“你好”工具作為概念驗證，後續版本將推出抵押貸款文檔解析功能。

🚀 快速開始

克隆倉庫

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

✨ 主要特性

• FastAPI 服務器：具備生產就緒功能，包含 API 密鑰身份驗證、速率限制支持以及 CORS 中間件配置。
• AI 代理框架集成：支持 CrewAI、AutoGen 和 LangChain 等框架。
• 可擴展架構：便於添加抵押貸款解析工具。
• 開源透明：支持社區貢獻。

📦 安裝指南

克隆倉庫

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

創建虛擬環境並安裝依賴項

python -m venv venv
source venv/bin/activate  # 在 Windows 上使用 `venv\Scripts\activate`
pip install -r requirements.txt

配置環境變量

編輯 .env 文件：

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

啟動服務器

uvicorn main:app --reload

💻 使用示例

基礎用法

檢查服務器狀態

請求：GET /health
響應：{ "status": "ok" }

獲取問候消息

請求：GET /hello/{name}
路徑參數：`name` (字符串)
示例響應："Hello, World!"

高級用法

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 的框架集成示例
• 基本“你好”工具，用於測試框架集成

即將推出的版本將包含抵押貸款文檔解析和比較工具。

路線圖

• ✅ 核心服務器基礎設施，帶安全和速率限制
• ✅ 與 CrewAI、AutoGen 和 LangChain 的框架集成
• ✅ 基本工具實現（“你好”端點）
• 🚧 將貸款估算 (LE) 解析為 MISMO 格式
• 🚧 房地產比較工具開發

速率限制

服務器使用 slowapi 實現速率限制，默認設置為每分鐘 120 次請求/每 IP。可以通過 RATE_LIMIT_PER_MINUTE 環境變量進行配置。

安全

• 所有端點均需 API 密鑰身份驗證，除 /health
• CORS 配置允許特定來源（通過 ALLOWED_ORIGINS 環境變量設置）
• 所有異常均被捕獲並返回適當的錯誤消息

貢獻

歡迎提出問題或提交代碼改進。

關於

該項目由 Confer Solutions 維護。如需幫助或支持，請聯繫 info@confersolutions.ai。

📄 許可證

本項目採用 MIT 許可證，詳見 LICENSE 文件獲取詳細信息。