MCP Echo Server
About
# MCP Echo Server ## Overview The MCP Echo Server is a lightweight Python-based microservice designed to provide simple echo functionality. It receives messages and returns them back to the client, serving as a basic diagnostic and testing tool within the MCP framework. ## Project Details - **Version**: 0.1.0 -…
Details
- License
- MIT license
Explore
- Message Echo: Returns any message sent to the server
- Comprehensive Validation: Robust input validation using Pydantic models
- Async Server Architecture: Built with asyncio for efficient performance
- Flexible Configuration: Configurable through environment variables and config files
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
MCP Echo ServerCommand (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
- Python 3.11 or higher
- pip
- (Optional) Virtual environment recommended
pip install chuk-mcp-echo-server
1. Clone the repository:
git clone <repository-url>
cd chuk-mcp-echo-server
2. Create a virtual environment:
python -m venv venv
source venv/bin/activate # On Windows, use venv\Scripts\activate
3. Install the package:
pip install . # Installs the package in editable mode
To set up for development:
pip install .[dev] # Installs package with development dependencies
from chuk_mcp_echo_server.main import main
if __name__ == "__main__":
main()
- NO_BOOTSTRAP: Set to disable component bootstrapping
- Other configuration options can be set in the configuration files
pytest
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"mcp echo server": {
"chuk-mcp-echo-server": {
"command": "python",
"args": [
"-m",
"venv",
"venv"
]
}
}
}
}McpServers
{
"chuk-mcp-echo-server": {
"command": "python",
"args": [
"-m",
"venv",
"venv"
]
}
}Overview
The MCP Echo Server is a lightweight Python-based microservice designed to provide simple echo functionality. It receives messages and returns them back to the client, serving as a basic diagnostic and testing tool within the MCP framework.
Project Details
- Version: 0.1.0
- Python Compatibility: Python 3.11+
Features
- Message Echo: Returns any message sent to the server
- Comprehensive Validation: Robust input validation using Pydantic models
- Async Server Architecture: Built with asyncio for efficient performance
- Flexible Configuration: Configurable through environment variables and config files
Dependencies
Core dependencies:
- mcp (>=1.6.0)
- pydantic (>=2.11.2)
- PyYAML (>=6.0.2)
Development dependencies:
- pytest (>=8.3.5)
Installation
Prerequisites
- Python 3.11 or higher
- pip
- (Optional) Virtual environment recommended
Install from PyPI
pip install chuk-mcp-echo-server
Install from Source
1. Clone the repository:
git clone <repository-url>
cd chuk-mcp-echo-server
2. Create a virtual environment:
python -m venv venv
source venv/bin/activate # On Windows, use venv\Scripts\activate
3. Install the package:
pip install . # Installs the package in editable mode
Development Installation
To set up for development:
pip install .[dev] # Installs package with development dependencies
Running the Server
Command-Line Interface
chuk-mcp-echo-server
Programmatic Usage
from chuk_mcp_echo_server.main import main
if __name__ == "__main__":
main()
Environment Variables
- NO_BOOTSTRAP: Set to disable component bootstrapping
- Other configuration options can be set in the configuration files
Available Tools
Echo
Input:
- message: The string message to echo back
Example:
echo("Hello, world!")
Returns:
- The original message in an EchoResult object
Development
Code Formatting
- Black is used for code formatting
- isort is used for import sorting
- Line length is set to 88 characters
Running Tests
pytest
Contributing
1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Ensure code passes formatting and testing
4. Commit your changes (git commit -m 'Add some AmazingFeature')
5. Push to the branch (git push origin feature/AmazingFeature)
6. Open a Pull Request
License
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
