mcp-test-kits 0.0.6

A comprehensive MCP testing server for debugging and testing MCP clients

MCP Test Kits - Python

Build from source using FastMCP.

Build

cd python
uv sync

---

stdio

{
  "mcpServers": {
    "mcp-test-kits": {
      "command": "uv",
      "args": ["run", "mcp-test-kits"],
      "cwd": "/path/to/mcp-test-kits/python",
      "transport": "stdio"
    }
  }
}

---

HTTP

Start server:

uv run mcp-test-kits --transport http --port 3000

MCP client config:

{
  "mcpServers": {
    "mcp-test-kits": {
      "url": "http://localhost:3000/mcp",
      "transport": "http"
    }
  }
}

With OAuth

Start server:

uv run mcp-test-kits --transport http --port 3000 --enable-oauth
# or auto-approve for testing
uv run mcp-test-kits --transport http --port 3000 --enable-oauth --oauth-auto-approve

MCP client config (OAuth discovery automatic):

{
  "mcpServers": {
    "mcp-test-kits": {
      "url": "http://localhost:3000/mcp",
      "transport": "http"
    }
  }
}

Or with pre-obtained token:

{
  "mcpServers": {
    "mcp-test-kits": {
      "url": "http://localhost:3000/mcp",
      "transport": "http",
      "headers": {
        "Authorization": "Bearer YOUR_ACCESS_TOKEN"
      }
    }
  }
}

---

SSE

Start server:

uv run mcp-test-kits --transport sse --port 3000

MCP client config:

{
  "mcpServers": {
    "mcp-test-kits": {
      "url": "http://localhost:3000/sse",
      "transport": "sse"
    }
  }
}

With OAuth

Start server:

uv run mcp-test-kits --transport sse --port 3000 --enable-oauth
# or auto-approve for testing
uv run mcp-test-kits --transport sse --port 3000 --enable-oauth --oauth-auto-approve

MCP client config (OAuth discovery automatic):

{
  "mcpServers": {
    "mcp-test-kits": {
      "url": "http://localhost:3000/sse",
      "transport": "sse"
    }
  }
}

Or with pre-obtained token:

{
  "mcpServers": {
    "mcp-test-kits": {
      "url": "http://localhost:3000/sse",
      "transport": "sse",
      "headers": {
        "Authorization": "Bearer YOUR_ACCESS_TOKEN"
      }
    }
  }
}

---

Test with MCP Inspector

# stdio
npx @modelcontextprotocol/inspector uv run mcp-test-kits

# HTTP (start server first: uv run mcp-test-kits --transport http --port 3000)
npx @modelcontextprotocol/inspector --transport http --server-url http://localhost:3000/mcp

# SSE (start server first: uv run mcp-test-kits --transport sse --port 3000)
npx @modelcontextprotocol/inspector --transport sse --server-url http://localhost:3000/sse

---

Development

uv sync --all-extras
uv run pytest
uv run mypy src --check-untyped-defs
uv run ruff check src