MCP Server

基本能力

产品定位

freedanfan_mcp_server 是一个用于标准化 AI 模型与开发环境之间交互的服务器，旨在简化模型部署和管理，提高开发效率。

核心功能

• JSON-RPC 2.0: 基于标准 JSON-RPC 2.0 协议的请求-响应通信
• SSE 连接: 支持服务器发送事件 (SSE) 连接，用于实时通知
• 模块化设计: 模块化架构，便于扩展和定制
• 异步处理: 使用 FastAPI 和异步 IO 实现高性能服务
• 完整客户端: 包含完整的测试客户端实现

适用场景

• AI 模型集成与管理
• 实时交互式 AI 应用
• 开发环境与 AI 模型的标准化交互

工具列表

• mcp_server.py: MCP 服务器主程序
• mcp_client.py: MCP 客户端测试程序
• base_router.py: 基础路由器实现

常见问题解答

1. 连接错误: 确保服务器正在运行且客户端使用正确的服务器 URL
2. 405 方法不允许: 确保客户端发送请求到正确的 API 端点
3. SSE 连接失败: 检查网络连接和防火墙设置

使用教程

使用依赖

1. 克隆仓库:

git clone https://github.com/freedanfan/mcp_server.git
cd mcp_server

1. 安装依赖:

pip install -r requirements.txt

安装教程

1. 启动服务器:

python mcp_server.py

默认情况下，服务器将在 127.0.0.1:12000 启动。可以通过环境变量自定义主机和端口:

export MCP_SERVER_HOST=0.0.0.0
export MCP_SERVER_PORT=8000
python mcp_server.py

1. 运行客户端:

python mcp_client.py

如果服务器不在默认地址运行，可以设置环境变量:

export MCP_SERVER_URL="http://your-server-address:port"
python mcp_client.py

调试方式

查看日志以获取更多信息:

export PYTHONPATH=.
python -m logging -v DEBUG -m mcp_server

许可证

该项目遵循 MIT 开源许可条款。