Mock MCP Server
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 "Deploy 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 Server list 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"
}
}
}Related MCP server: http-mcp-server
CHANGELOG
Available Tools
1 toolmock_echoB
Echo back the provided message.
Inputs: message (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
With only one tool, there is no possibility of confusion or overlap between tools. The tool 'mock_echo' has a single, clear purpose of echoing messages, making it perfectly distinct.
The tool name 'mock_echo' follows a consistent verb_noun pattern (echo as the verb, implied message as the noun). Since there is only one tool, naming consistency is inherently perfect with no deviations to assess.
A single tool is generally too few for most server purposes, as it limits functionality and suggests a trivial or incomplete scope. For a server named 'Mock MCP Server', which implies broader mocking capabilities, one tool feels insufficient and under-scoped.
The server's purpose is unclear from the name 'Mock MCP Server', but a single echo tool suggests severe incompleteness. It lacks coverage for common mocking operations like simulating data, errors, or varied responses, creating significant gaps that could cause agent failures in typical use cases.
Maintenance
Related MCP Connectors
AI-native mock API server with MCP. Create REST/SOAP mocks from Claude, Cursor, or Windsurf.
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
MCP server for progressive tool usage at any scale (see https://klavis.ai)
MCP server for building and testing AI agents with multi-model experimentation and insights.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA minimal demonstration server showcasing MCP protocol capabilities including tools, resources, and prompts with basic examples like hello world functionality.6 npmMIT
- AlicenseNot gradedqualityDmaintenanceMock HTTP server implementing MCP (Model Context Protocol) with streamable HTTP transport, health endpoint, and example tools like echo and time.556 npmMIT
- AlicenseBqualityDmaintenanceA toy MCP server for exploring Model Context Protocol capabilities, including resources, tools, and prompts.1Apache 2.0
- AlicenseNot gradedqualityDmaintenanceA lightweight mock MCP server for local testing and resilience experiments, providing predictable tool responses with simulated latency and errors.1MIT