MCP Echo Server

by chrishayuk

95 downloads
Not rated
GitHub

Description

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

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

Author
chrishayuk
Downloads
95
Categories
Other

- Message echo: returns any sent message
- Comprehensive input validation using Pydantic models
- Async server architecture built with asyncio
- Flexible configuration via 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:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name MCP Echo Server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install via pip: pip install chuk-mcp-echo-server, then run chuk-mcp-echo-server from the command line. Use the echo tool with a message string to echo back input.

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"
        ]
    }
}

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

MIT License

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.