Mock MCP Server
A mock MCP server for testing MCP client implementations and development workflows.
Support tools, prompts and resources.
Usage
Full CLI Usage
uvx mock-mcp-server --help
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"
}
}
}