Test MCP

Diagram: https://excalidraw.com/#json=uRRaOjlO8rV6Og36vjPEj,LRARtOLrhz0VdTFIxjH8Rg

Requirements

• uv to manage the Python environment

• nodejs for testing

• MCP clients to actually use it

  • Claude Desktop

  • Visual Studio Code

    • Cline

    • Roo Code

    • Kilo Code

  • Jan

Note: OpenRouter has many free models available that you can use for testing.

Related MCP server: My Awesome MCP

Development

For testing you can run a development server and manually run tool calls:

uv run fastmcp dev

The fully example is implemented in test-mcp.py, a minimal example you can use in your own projects is in minimal-mcp.py.

Installation

To install your MCP server you need to configure an MCP.json that looks something like this:

{
  "mcpServers": {
    "test-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/Users/admin/Projects/test-mcp",
        "run",
        "test-mcp.py"
      ],
      "timeout": 600
    }
  }
}

For Claude Desktop there is a detailed guide available.