echo-mcp-server-for-testing
About
A simple echo MCP (Model Context Protocol) Server for testing MCP Clients.
Details
- Author
- piebro
- GitHub stars
- 2
- Downloads
- 301
- Categories
- Other, Developer Tools
Jump to
- Provides an echo_tool for testing MCP Clients.
- Can be used as a template for new MCP Servers.
- Simple to run with uvx or local uv.
- Requires a SECRET_KEY environment variable.
- Supports testing via mcp-client-for-testing.
- MIT licensed.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
echo-mcp-server-for-testingCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install and run the server using uvx or by cloning the repository and using uv with a directory. Add the appropriate configuration to your MCP client’s config file, including the required SECRET_KEY environment variable.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"echo-mcp-server-for-testing": {
"echo-mcp-server-for-testing": {
"name": "echo-mcp-server-for-testing",
"command": "uvx",
"args": [
"echo-mcp-server-for-testing"
],
"env": {
"SECRET_KEY": "123456789"
}
}
}
}
}McpServers
{
"echo-mcp-server-for-testing": {
"name": "echo-mcp-server-for-testing",
"command": "uvx",
"args": [
"echo-mcp-server-for-testing"
],
"env": {
"SECRET_KEY": "123456789"
}
}
}echo-mcp-server-for-testing
A simple echo MCP (Model Context Protocol) Server with a simple echo_tool for testing MCP Clients.
It is also great as a template for new MCP Servers.
Usage
Install uv and add the server to an MCP config using uvx:
{
"name": "echo-mcp-server-for-testing",
"command": "uvx",
"args": [
"echo-mcp-server-for-testing"
],
"env": {
"SECRET_KEY": "123456789"
}
}
or clone the repo and use uv with a directory:
{
"name": "echo-mcp-server-for-testing",
"command": "uv",
"args": [
"--directory",
"path/to/root/dir/",
"run",
"main.py"
],
"env": {
"SECRET_KEY": "123456789"
}
}
Development
Testing
Clone the repo and use mcp-client-for-testing to test the tools of the server.
uvx mcp-client-for-testing \
--config '
[
{
"name": "echo-mcp-server-for-testing",
"command": "uv",
"args": [
"--directory",
"path/to/root/dir/",
"run",
"main.py"
],
"env": {
"SECRET_KEY": "123456789"
}
}
]
' \
--tool_call '{"name": "echo_tool", "arguments": {"message": "Hello, world!"}}'
Formatting and Linting
The code is formatted and linted with ruff:
uv run ruff format
uv run ruff check --fix
Building with uv
Build the package using uv:
uv build
Releasing a New Version
To release a new version of the package to PyPI, create and push a new Git tag:
1. Checkout the main branch and get the current version:
git checkout main
git pull origin main
git describe --tags
2. Create and push a new Git tag:
git tag v0.2.0
git push origin v0.2.0
The GitHub Actions workflow will automatically build and publish the package to PyPI when a new tag is pushed.
The python package version number will be derived directly from the Git tag.
License
This project is licensed under the MIT License. See the LICENSE file for details.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
