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": {
"command": "uvx",
"args": ["mock-mcp-server"]
}
}
}
Streamable HTTP
Start server first:
uvx mock-mcp-server --transport http --host 127.0.0.1 --port 8000
Then configure your MCP client:
{
"mcpServers": {
"mock": {
"url": "http://127.0.0.1:8000"
}
}
}
SSE
Start server first:
uvx mock-mcp-server --transport sse --host 127.0.0.1 --port 8000
Then configure your MCP client:
{
"mcpServers": {
"mock": {
"url": "http://127.0.0.1:8000"
}
}
}
CHANGELOG
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Tools
A mock MCP server for testing MCP client implementations and development workflows. Supports tools, prompts, and resources across multiple transport protocols (stdio, HTTP, SSE).