Echo MCP Server

by aadversteeg

206 downloads Not rated yet MIT license

About

A Model Context Protocol (MCP) server implementing a echo service using .NETCORE

Details

License
MIT license

Explore

- Echo any message back to the client
- Customizable message format through configuration
- Built on the Model Context Protocol standard

- .NET 9.0 (for local development/deployment)
- Docker (for container deployment)

To configure Claude Desktop to use a locally installed Echo server:

1. Add the server configuration to the mcpServers section in your Claude Desktop configuration:
``json
"echo": {
"command": "dotnet",
"args": [
"YOUR_PATH_TO_DLL\\Core.Infrastructure.McpServer.dll"
],
"env": {
"MessageFormat": "Claude says: {message}"
}
}
`

2. Save the file and restart Claude Desktop

To add the echo server to Claude Code, use the following command:

`bash
claude mcp add echo -- docker run -i --rm -e MessageFormat="Claude says: {message}" aadversteeg/echo-mcp-server:latest
`

You can customize the message format by modifying the MessageFormat environment variable.

To use a custom configuration file from your host system:

1. Create a custom configuration file on your host machine (e.g.,
echo-appsettings.json):
`json
{
"MessageFormat": "My Custom Format: {message}",
"Logging": {
"LogLevel": {
"Default": "Information",
"Microsoft": "Warning"
}
}
}
`

2. Update the Claude Desktop configuration to mount this file:
`json
"echo": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"-v", "C:/path/to/echo-appsettings.json:/app/appsettings.json",
"echo-mcp-server:latest"
]
}
`

Important Notes:
- The configuration file must exist on your host system before starting the container
- You can use any filename on the host (e.g.,
echo-appsettings.json), but it must be mounted to /app/appsettings.json` inside the container
- Make sure the path is correct for your operating system (Windows uses backslashes or forward slashes, Linux/macOS use forward slashes)
- After changing the configuration file, restart Claude Desktop to apply the changes

3. Save the file and restart Claude Desktop

A simple echo server implementing the Model Context Protocol (MCP). This server provides a basic echo functionality through the MCP interface.

Overview

The Echo MCP server is built with .NET Core using the Model Context Protocol C# SDK (github.com/modelcontextprotocol/csharp-sdk). It provides a tool for echoing messages back to the client. The server is designed to be lightweight and demonstrates how to create a custom MCP server with a simple functionality. It can be deployed either directly on a machine or as a Docker container.

Features

- Echo any message back to the client - Customizable message format through configuration - Built on the Model Context Protocol standard

Getting Started

Prerequisites

- .NET 9.0 (for local development/deployment) - Docker (for container deployment)

Build Instructions (for development)

If you want to build the project from source: 1. Clone this repository: ``bash git clone https://github.com/yourusername/echo-mcp-server.git ` 2. Navigate to the project root directory: `bash cd echo-mcp-server ` 3. Build the project using: `bash dotnet build src/echo.sln ` 4. Run the tests: `bash dotnet test src/echo.sln `

Docker Support

Manual Docker Build

To build the Docker image yourself:
``bash
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.