🚀 房地产比较平台 (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 文件获取详细信息。