Test Dh MCP

🚀 Server Testing

This project is designed for server testing, providing a series of installation, operation, and testing steps to ensure the proper functioning of the server.

🚀 Quick Start

Prerequisites

Before starting, you need to ensure that the following environments and tools are installed:

• Python environment
• Homebrew (for MacOS)
• npm

📦 Installation

Using venv

python -m venv venv
source venv/bin/activate  # On MacOS/Linux
# Or
# venv\Scripts\activate  # On Windows
pip install -r requirements.txt

Using uv

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

💻 Usage Examples

Running the Server

SSE Mode

python mcp_server.py --transport sse

Stdio Mode

python mcp_server.py --transport stdio

Installing Tools

Using venv

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

Using uv

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

Testing Tools

Checking Available Tools

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

Using Tools

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

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

📚 Documentation

Configuration File

Example Configuration File (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"
            }
        ]

Defining Tools

Defining New Tools in dhmcp/init.py

from mcp_server import MCPServer

@mcp_server.tool()
def echo_tool(message: str) -> str:
    """
    Echo tool, returns the input message with the prefix 'Echo:'.
    """
    return f"Echo: {message}"

🔧 Troubleshooting

Checking if the Server is Running

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

MCP Inspector

Installing MCP Inspector

npm install -g @modelcontextprotocol/inspector@latest

Running MCP Inspector

SSE Mode

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

Stdio Mode

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

⚠️ Important Note

When using MCP Inspector, all string values must be enclosed in quotes (e.g., "worker1"). If quotes are not used, the Inspector may send null or invalid values to the server. Values can be verified by clicking the Format JSON button.