Skip to content
MCP server

MCP Test

Minimal MCP server with a single echo tool, useful for testing MCP client setups

Runs locallyStatus and history
Install
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-server

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp-test": {
      "command": "uvx",
      "args": [
        "mcp-echo-server"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-test": {
      "command": "uvx",
      "args": [
        "mcp-echo-server"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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.

How AIPoweredBot checks servers