MCP Test Server

A simple MCP server with an echo tool that returns back your messages for testing MCP clients.

python

0

GitHub Stars

python

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "bharath-krishna-mcp-test": {
      "command": "mcp-echo-server",
      "args": []
    }
  }
}

You can run a minimal MCP server that exposes a testing echo tool. This server is handy for validating your MCP client workflows by sending a message and receiving the same message back, ensuring the end-to-end communication path works as expected.

How to use

To use this server with your MCP client, add it as an MCP endpoint in your client configuration. Point the client at the echo server and call the echo tool with a message. The server will return the exact message you sent, allowing you to verify that requests and responses travel correctly, and to test client retries, timeouts, and handling of simple tool invocations.

How to install

Prerequisites: you need Python and pip installed on your system.

pip install mcp-echo-server

Additional notes

Once installed, start the server from your terminal by running the echo server command shown in your environment. You will use this same command in your MCP client configuration to connect to the echo service.

Example client configuration snippet to connect to the echo server is shown below. This informs your MCP client to use the echo server when performing tool invocations.

{
  "mcpServers": {
    "mcp-echo-server": {
      "command": "mcp-echo-server"
    }
  }
}

Available tools

echo

Echoes back the provided message. Input: message (string, required). Output: Echo: <your message>.