mcpField
M
MCP Echo Server

MCP Echo Server

Local
github.com/chrishayukDeveloper Tools1Updated 81w ago
Repository

About MCP Echo Server

MCP Echo Server is a Python microservice for testing and diagnosing MCP connections. Its Echo tool returns submitted messages and validates input with Pydantic.

Key features

  1. 01Echoes submitted messages
  2. 02Pydantic input validation
  3. 03Asyncio-based server
  4. 04Environment and file configuration

Use cases

  1. 01Testing an MCP client connection
  2. 02Checking message handling
  3. 03Validating echo inputs

MCP support

It exposes an Echo tool to MCP clients, returning the supplied message in an EchoResult object.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

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
  1. Create a virtual environment:
python -m venv venv
source venv/bin/activate  # On Windows, use `venv\Scripts\activate`
  1. 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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.