The Mock MCP Server is a testing tool for validating MCP (Model Context Protocol) client implementations and development workflows. It provides a single mock_echo tool that takes a message parameter (string) and returns it wrapped in a result field. The server supports multiple transport protocols—stdio for local integration, Streamable HTTP, and SSE (Server-Sent Events)—and can be configured via command-line arguments for transport type, host, and port (default: 127.0.0.1:8000). It's designed for testing connectivity, validating tool calling workflows, debugging protocol communication across transports, and quick prototyping—not for production use.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Mock MCP Serverlist available tools for testing"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Mock MCP Server
A mock MCP server for testing MCP client implementations and development workflows.
Support tools, prompts and resources.
Usage
Full CLI 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 7788Then 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 7789Then configure your MCP client:
{
"mcpServers": {
"mock-sse": {
"url": "http://127.0.0.1:7789/sse"
}
}
}