mrexodia/test-mcp

Simple MCP server for testing purposes.

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.

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.