# MCP Test

> MCP Test is an open-source MCP server for developer tools. Minimal MCP server with a single echo tool, useful for testing MCP client setups. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Linux, macOS, Windows
- **Repository:** https://github.com/bharath-krishna/mcp-test
- **MCP Registry name:** io.github.bharath-krishna/mcp-test
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp-test -- uvx mcp-echo-server
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp-test": {
      "command": "uvx",
      "args": [
        "mcp-echo-server"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp-test": {
      "command": "uvx",
      "args": [
        "mcp-echo-server"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp-test": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-echo-server"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp-test": {
      "command": "uvx",
      "args": [
        "mcp-echo-server"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp-test": {
      "command": "uvx",
      "args": [
        "mcp-echo-server"
      ]
    }
  }
}
```

## Tools

- `echo`: Echoes back the provided message.

## 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.

## Alternatives

- [python-sdk](https://ai-powered.com/mcp/python-sdk): python-sdk is an open-source MCP server for developer tools.
- [Simple MCP](https://ai-powered.com/mcp/simple-mcp): Simple MCP is an open-source MCP server for developer tools.
- [Makefile MCP](https://ai-powered.com/mcp/makefile-mcp-2): Makefile MCP is an open-source MCP server for developer tools.
- [MCP Server Commands](https://ai-powered.com/mcp/mcp-server-commands): MCP Server Commands is an open-source MCP server for developer tools.
- [Tiny Go MCP Server](https://ai-powered.com/mcp/tiny-go-mcp-server): Tiny Go MCP Server is an open-source MCP server for developer tools.
- [MCP Failure Lab](https://ai-powered.com/mcp/mcp-failure-lab-2): MCP Failure Lab is an open-source MCP server for developer tools.
- [MCP Foundry — Build, Test & Publish MCP Servers](https://ai-powered.com/mcp/mcp-foundry-build-test-and-publish-mcp-servers): MCP Foundry — Build, Test & Publish MCP Servers is a freemium MCP server for developer tools.
- [OneTool MCP](https://ai-powered.com/mcp/onetool-mcp): OneTool MCP is an open-source MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/mcp-test-2
