MCP Test
Minimal MCP server with a single echo tool, useful for testing MCP client setups
- Pricing
- Open source
- Platforms
- CLI, Linux, macOS
- Runs
- Locally
- Version
- 0.1.0
- Listing updated
- today
Similar MCP servers
About MCP Test
MCP Test is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.
The README describes this as a bare-bones Model Context Protocol server whose only job is to return whatever message it receives. It is distributed as a Python package on PyPI and runs over stdio, so it can be added to an MCP client configuration with a single command entry.
The server exposes one tool named echo, which takes a required message string and returns it prefixed with "Echo:". The repository also documents an editable development install using uv, which suits anyone who wants to modify the code.
This is aimed at developers who need a predictable tool to check that an MCP client connects, lists tools and passes arguments correctly, rather than a tool for real work.
Install
Run in a terminal
claude mcp add mcp-test -- uvx mcp-echo-serverAdd to claude_desktop_config.json
{
"mcpServers": {
"mcp-test": {
"command": "uvx",
"args": [
"mcp-echo-server"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp-test": {
"command": "uvx",
"args": [
"mcp-echo-server"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"mcp-test": {
"type": "stdio",
"command": "uvx",
"args": [
"mcp-echo-server"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcp-test": {
"command": "uvx",
"args": [
"mcp-echo-server"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"mcp-test": {
"command": "uvx",
"args": [
"mcp-echo-server"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
Tools this server provides (1)
Taken from the project documentation; the running server may differ.
- echo
- Echoes back the provided message.
What it does
- Single echo tool
- Exposes one tool that returns the supplied message unchanged, prefixed with a label.
- Stdio transport
- Runs over standard input and output, the transport used by common local MCP clients.
- PyPI installation
- Installable with pip under the package name mcp-echo-server.
- Client configuration example
- The README includes a JSON snippet for registering the server in an MCP client.
- Editable development install
- Documents an editable install with uv for working on the source.
Good for
- Verifying that an MCP client can launch a local stdio server
- Testing how a client passes string arguments to a tool
- Serving as a starting template for a minimal Python MCP server
Pricing
Open source
Free and open source; no paid plan mentioned.
MCP Test FAQ
What tools does this server provide?
It provides one tool, echo, which takes a required message string and returns it as "Echo: <message>".
How do I install it?
The README says to run pip install mcp-echo-server, then add the command mcp-echo-server to your MCP client configuration.
What transport does it use?
It uses stdio, as listed in its registry entry and package metadata.
Is MCP Test free?
Yes. MCP Test is open source, so you can use and self-host it for free.
How do I add MCP Test to Claude Code?
Run this command in your terminal: claude mcp add mcp-test -- uvx mcp-echo-server
What are the best alternatives to MCP Test?
The closest alternatives to MCP Test are python-sdk, Simple MCP, Makefile MCP, MCP Server Commands and Tiny Go MCP Server.
Where this comes from
- Description: written from the project's README and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.
