Mock MCP Server

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

Support tools, prompts and resources.

Usage

Full CLI Usage

<details>

<summary><code>uvx mock-mcp-server --help</code></summary>

 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.          │
╰─────────────────────────────────────────────────────────────────────────────────────╯

</details>

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