Mock MCP Server

Mock MCP Server

A mock MCP server for testing MCP client implementations and development workflows.

Support tools, prompts and resources.

Usage

Full Usage

 Usage: mock-mcp-server [OPTIONS]

 Mock MCP Server for testing.

╭─ Options ───────────────────────────────────────────────────────────────────────────────────╮
│ --transport        [stdio|http|sse|streamable-http]  Transport type [default: stdio]        │
│ --host             TEXT                              Host to bind to [default: 127.0.0.1]   │
│ --port             INTEGER                           Port to bind to [default: 8000]        │
│ --version                                            Show version and exit                  │
│ --help                                               Show this message and exit.            │
╰─────────────────────────────────────────────────────────────────────────────────────────────╯

Stdio

Add to your MCP client configuration:

{
  "mcpServers": {
    "mock-stdio": {
      "command": "uvx",
      "args": ["mock-mcp-server"]
    }
  }
}

Streamable HTTP

Start server first:

uvx mock-mcp-server --transport http --host 127.0.0.1 --port 7788

Then configure your MCP client:

{
  "mcpServers": {
    "mock-streamable-http": {
      "url": "http://127.0.0.1:7788/mcp"
    }
  }
}

SSE

Start server first:

uvx mock-mcp-server --transport sse --host 127.0.0.1 --port 7789

Then configure your MCP client:

{
  "mcpServers": {
    "mock-sse": {
      "url": "http://127.0.0.1:7789/sse"
    }
  }
}

CHANGELOG