test-dh-mcp

test-dh-mcp

site icon
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 的集成。

核心功能

  1. 多通道协议支持:支持 SSE 和 stdio 两种传输方式。
  2. 工具注册:通过 @mcp_server.tool() 装饰器注册自定义工具。
  3. 客户端/服务器通信:提供示例客户端代码用于测试工具。
  4. 集成支持:支持与 Claude Desktop 和 MCP Inspector 集成。

适用场景

  1. 开发工具集成:用于在 Claude Desktop 中集成自定义工具。
  2. 协议调试:使用 MCP Inspector 调试 MCP 服务器状态。
  3. 多通道通信:支持 SSE 和 stdio 两种通信方式,适用于不同场景。

工具列表

  1. MCP Inspector:用于调试和检查 MCP 服务器状态。
  2. Claude Desktop:用于集成自定义工具。

常见问题解答

  1. 服务器未运行
  2. SSE 模式:使用 curl http://localhost:8000/sse 检查。
  3. Stdio 模式:检查 Claude/Inspector 日志。
  4. 工具定义更改:需要重启服务器。
  5. 连接问题:确保服务器运行在正确的地址/端口(SSE)或正确附加到 stdio(Claude/Inspector)。

使用教程

使用依赖

  1. 安装依赖bash uv pip install autogen-ext mcp[cli]
  2. 同步环境bash uv pip install

安装教程

  1. 创建虚拟环境bash python3 -m venv venv source venv/bin/activate pip install -r requirements.txt 或使用 uvbash uv pip install -r requirements.txt

  2. 运行 MCP 服务器

  3. SSE 传输bash python src/mcp_server.py
  4. Stdio 传输bash python src/mcp_server.py --transport stdio

调试方式

  1. 运行客户端bash cd src python -m mcp_client 或使用 uvbash cd src uv run mcp_client.py

  2. 使用 MCP Inspectorbash npm install -g @modelcontextprotocol/inspector cd src npx @modelcontextprotocol/inspector uv run mcp_server.py --transport sse

许可证

该项目遵循 Apache-2.0 开源许可条款,请参阅 Apache-2.0 了解完整条款。