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

💻 サーバーの実行

SSE モード

python mcp_server.py --transport sse

Stdio モード

python mcp_server.py --transport stdio

🛠️ ツールのインストール

使用 venv

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

使用 uv

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

🧪 ツールのテスト

利用可能なツールの確認

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 按钮进行验证。