mcp-utils
2025.04.06
0
PythonMCP 服务器工具Python 开发工具开发效率
mcp-utils 是一个 Python 工具包，用于构建符合 Model Context Protocol (MCP) 规范的服务器。它专注于同步实现，特别适合希望在现有 Python 应用程序中实现 MCP 服务器而无需处理异步代码复杂性的开发者。
View on GitHub
Overview
基本能力
产品定位
mcp-utils 是一个用于构建 MCP 服务器的 Python 工具包，旨在简化 MCP 服务器的实现过程，特别适合同步应用程序开发。
核心功能
- 提供 MCP 服务器实现的基本工具
- 支持服务器发送事件 (SSE)
- 提供简单的装饰器来定义 MCP 端点
- 同步实现
- 支持 HTTP 协议
- Redis 响应队列支持
- 全面的 Pydantic 模型用于 MCP 模式
- 内置验证和文档生成
适用场景
- 在现有 Flask 应用程序中实现 MCP 服务器
- 需要与 Claude Desktop 集成的项目
- 需要同步 MCP 服务器实现的场景
- 需要 Redis 队列支持的 MCP 服务器
- 需要 SQLAlchemy 事务管理的 MCP 服务器
工具列表
- MCPServer: 核心 MCP 服务器类，用于创建和管理 MCP 服务器
- RedisResponseQueue: 使用 Redis 作为响应队列的实现
- MCP Inspector: 用于测试和调试 MCP 服务器的工具
- mcp-proxy: 用于连接 Claude Desktop 和 MCP 服务器的代理工具
常见问题解答
-
Q: 如何连接 Claude Desktop 与 MCP 服务器？ A: 需要使用 mcp-proxy 工具作为中介，配置 Claude Desktop 使用该代理。
-
Q: 是否支持异步实现？ A: 不，mcp-utils 专注于同步实现，如果需要异步支持，可以使用官方 MCP Python SDK。
-
Q: 如何测试 MCP 服务器？ A: 可以使用 MCP Inspector 工具来测试和调试服务器实现。
使用教程
使用依赖
- Python 3.10+
- Pydantic 2
可选依赖: - Flask (用于 web 服务器) - Gunicorn (用于生产部署) - Redis (用于响应队列)
安装教程
pip install mcp-utils
调试方式
- 安装 MCP Inspector:
npm install -g @modelcontextprotocol/inspector
- 启动 MCP Inspector:
git clone [email protected]:modelcontextprotocol/inspector.git
cd inspector
npm run build
npm start
- 在浏览器中访问
http://127.0.0.1:6274/并输入 MCP 服务器 URL 进行测试。