Test Dh MCP

🚀 服务器测试

本项目主要用于服务器的相关测试，包含服务器的安装、运行、工具使用、配置等一系列操作，帮助用户快速搭建和测试服务器环境。

🚀 快速开始

环境准备

使用 venv

python -m venv venv
source venv/bin/activate  # 在 MacOS/Linux 上
# 或者
# venv\Scripts\activate  # 在 Windows 上
pip install -r requirements.txt

使用 uv

brew install uv
uv --version
npm install -g @modelcontextprotocol/core

📦 安装指南

使用 venv

source venv/bin/activate
pip install -r requirements.txt
deactivate

使用 uv

uv run mcp_server.py --tool echo_tool
# 输出:
# {'result': 'Echo: Hello World'}

💻 使用示例

运行服务器

SSE 模式

python mcp_server.py --transport sse

Stdio 模式

python mcp_server.py --transport stdio

测试工具

检查可用工具

curl http://localhost:8000/sse
# 或者
python -m mcp_client list_tools --transport stdio

使用工具

python -m mcp_client echo_tool --message "Hello World" --transport sse
# 输出:
# {"result": "Echo: Hello World"}

python -m mcp_client gnome_count_colorado --transport stdio
# 输出:
# {"result": 42}

配置文件

示例配置文件 (mcp_server_config.py)

class Config:
    def __init__(self):
        self.workers = [
            {
                "name": "worker1",
                "address": "localhost:8000",
                "transport": "sse"
            },
            {
                "name": "worker2",
                "address": "localhost:8001",
                "transport": "stdio"
            }
        ]

定义工具

在 dhmcp/init.py 中定义新工具

from mcp_server import MCPServer

@mcp_server.tool()
def echo_tool(message: str) -> str:
    """
    回显工具，返回输入消息并添加前缀 'Echo:'。
    """
    return f"Echo: {message}"

🔧 技术细节

故障排除

检查服务器是否运行

curl http://localhost:8000/sse
# 或者
python -m mcp_client list_tools --transport stdio

MCP Inspector

安装 MCP Inspector

npm install -g @modelcontextprotocol/inspector@latest

运行 MCP Inspector

SSE 模式

npx @modelcontextprotocol/inspector@latest \
/Users/chip/dev/test-dh-mcp/venv/bin/python3 mcp_server.py --transport sse

Stdio 模式

npx @modelcontextprotocol/inspector@latest \
/Users/chip/dev/test-dh-mcp/venv/bin/python3 mcp_server.py --transport stdio

⚠️ 重要提示

• 当使用 MCP Inspector 时，所有字符串值都必须用引号括起来（例如："worker1"）。
• 如果不使用引号，Inspector 可能会发送 null 或无效值到服务器。
• 值可以通过点击 Format JSON 按钮进行验证。