基本能力
产品定位
MCP Server 是一个用于标准化 AI 模型与开发环境交互的中间件,旨在简化 AI 模型的部署和管理。
核心功能
- JSON-RPC 2.0: 基于标准的 JSON-RPC 2.0 协议进行请求-响应通信。
- SSE 连接: 支持服务器发送事件(SSE)连接,用于实时通知。
- 模块化设计: 采用模块化架构,便于扩展和定制。
- 异步处理: 使用 FastAPI 和异步 IO 实现高性能服务。
- 完整客户端: 包含完整的测试客户端实现。
适用场景
- AI 模型集成与管理
- 实时数据处理与通知
- 开发环境与 AI 模型的标准化交互
工具列表
- mcp_server.py: MCP 服务器主程序。
- mcp_client.py: MCP 客户端测试程序。
- routers/base_router.py: 基础路由器实现。
常见问题解答
- 连接错误: 确保服务器正在运行且客户端使用了正确的服务器 URL。
- 405 方法不允许: 确保客户端将请求发送到正确的 API 端点。
- SSE 连接失败: 检查网络连接和防火墙设置。
使用教程
使用依赖
bash
git clone https://github.com/freedanfan/mcp_server.git
cd mcp_server
pip install -r requirements.txt
安装教程
- 克隆仓库并安装依赖(如上所述)。
-
启动服务器:
bash
python mcp_server.py
默认情况下,服务器将在127.0.0.1:12000
上启动。可以通过环境变量自定义主机和端口:
bash
export MCP_SERVER_HOST=0.0.0.0
export MCP_SERVER_PORT=8000
python mcp_server.py -
运行客户端:
bash
python mcp_client.py
如果服务器未在默认地址运行,可以设置环境变量:
bash
export MCP_SERVER_URL="http://your-server-address:port"
python mcp_client.py
调试方式
增加日志级别以获取更多信息:
bash
export PYTHONPATH=.
python -m logging -v DEBUG -m mcp_server