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 按鈕進行驗證。