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