
test-dh-mcp

2025.04.23
0
Python多通道协议工具集成开发效率
test-dh-mcp 是一个基于 FastMCP 实现的多通道协议(MCP)服务器项目,用于演示如何定义和运行 MCP 服务器。该项目支持工具注册、服务器/客户端使用以及与 Claude Desktop 和 MCP Inspector 的集成。
View on GitHub
Overview
基本能力
产品定位
test-dh-mcp 是一个多通道协议(MCP)服务器,用于支持工具注册、服务器/客户端通信以及与 Claude Desktop 和 MCP Inspector 的集成。
核心功能
- 多通道协议支持:支持 SSE 和 stdio 两种传输方式。
- 工具注册:通过
@mcp_server.tool()
装饰器注册自定义工具。 - 客户端/服务器通信:提供示例客户端代码用于测试工具。
- 集成支持:支持与 Claude Desktop 和 MCP Inspector 集成。
适用场景
- 开发工具集成:用于在 Claude Desktop 中集成自定义工具。
- 协议调试:使用 MCP Inspector 调试 MCP 服务器状态。
- 多通道通信:支持 SSE 和 stdio 两种通信方式,适用于不同场景。
工具列表
- MCP Inspector:用于调试和检查 MCP 服务器状态。
- Claude Desktop:用于集成自定义工具。
常见问题解答
- 服务器未运行:
- SSE 模式:使用
curl http://localhost:8000/sse
检查。 - Stdio 模式:检查 Claude/Inspector 日志。
- 工具定义更改:需要重启服务器。
- 连接问题:确保服务器运行在正确的地址/端口(SSE)或正确附加到 stdio(Claude/Inspector)。
使用教程
使用依赖
- 安装依赖:
bash uv pip install autogen-ext mcp[cli]
- 同步环境:
bash uv pip install
安装教程
-
创建虚拟环境:
bash python3 -m venv venv source venv/bin/activate pip install -r requirements.txt
或使用uv
:bash uv pip install -r requirements.txt
-
运行 MCP 服务器:
- SSE 传输:
bash python src/mcp_server.py
- Stdio 传输:
bash python src/mcp_server.py --transport stdio
调试方式
-
运行客户端:
bash cd src python -m mcp_client
或使用uv
:bash cd src uv run mcp_client.py
-
使用 MCP Inspector:
bash npm install -g @modelcontextprotocol/inspector cd src npx @modelcontextprotocol/inspector uv run mcp_server.py --transport sse