MCP Server

MCP Server

site icon
2025.03.08 5
PythonAI 模型集成实时数据处理开发环境交互开发效率
MCP Server 是一个基于 FastAPI 和 MCP(Model Context Protocol)的项目,旨在标准化 AI 模型与开发环境之间的上下文交互。它通过简化模型部署、提供高效的 API 端点以及确保模型输入和输出的一致性,增强了 AI 应用的可扩展性和可维护性,使开发者能够更轻松地集成和管理 AI 任务。
View on GitHub

Overview

基本能力

产品定位

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: 基础路由器实现。

常见问题解答

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

使用教程

使用依赖

git clone https://github.com/freedanfan/mcp_server.git
cd mcp_server
pip install -r requirements.txt

安装教程

  1. 克隆仓库并安装依赖(如上所述)。
  2. 启动服务器:
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 开源许可条款。