Echo MCP Server

回声MCP服务器

一个实现模型上下文协议（MCP）的简单回声服务器。此服务器通过MCP接口提供基本的回声功能。

概述

Echo MCP服务器是用构建的。NET Core使用模型上下文协议C#SDK().它提供了一个将消息回显到客户端的工具。该服务器设计为轻量级，并演示了如何创建具有简单功能的自定义MCP服务器。它可以直接部署在机器上，也可以作为Docker容器部署。

特性

• 将任何消息回传给客户端
• 通过配置可定制的消息格式
• 基于模型上下文协议标准构建

入门指南

先决条件

• .NET 10.0（用于本地开发/部署）
• Docker（用于容器部署）

构建说明（用于开发）

如果要从源代码构建项目：

1. 克隆此存储库：

   git clone https://github.com/yourusername/echo-mcp-server.git

1. 导航到项目根目录：

   cd echo-mcp-server

1. 使用以下方式构建项目：

   dotnet build src/echo.sln

1. 运行测试：

   dotnet test src/echo.sln

.NET工具

Echo MCP服务器可作为。NET全局工具。

安装

dotnet tool install --global Ave.McpServer.Echo

跑步

ave-mcpserver-echo

一次性执行（无需永久安装）

和。NET 10 SDK，您可以使用以下命令运行该工具，而无需全局安装 dotnet tool exec:

dotnet tool exec -y ave.mcpserver.echo

这 -y 标志自动接受提示。该工具在本地缓存，但不会添加到PATH中。

Docker支持

手动Docker构建

要自己构建Docker镜像：

# Navigate to the repository root
cd echo-mcp-server

# Build the Docker image
docker build -f src/Core.Infrastructure.McpServer/Dockerfile -t echo-mcp-server:latest src/

# Run the locally built image
docker run -d --name echo-mcp echo-mcp-server:latest

MCP协议使用

客户端集成

要从应用程序连接到Echo MCP服务器：

1. 使用模型上下文协议C#SDK或任何兼容MCP的客户端
2. 配置您的客户端以连接到服务器的端点
3. 调用下面描述的可用工具

可用工具

回声

将消息回传给客户端。

参数：

• message （必填）：要回显的消息。

请求示例：

{
  "name": "echo",
  "parameters": {
    "message": "Hello, world!"
  }
}

示例响应：

Echo: Hello, world!

配置

消息格式

这 MessageFormat 设置决定了回显消息的格式。它使用一个模板字符串 {message} 被输入消息替换的占位符。

您可以通过两种方式设置MessageFormat：

1. 应用程序参数 文件（用于本地部署）：

{
  "MessageFormat": "Server says: {message}"
}

1. 环境变量 （适用于集装箱化部署）：

当将MCP服务器与Claude一起使用时，环境变量通过Claude桌面配置传递，如下面的“配置Claude桌面”部分所示。

如果未指定，服务器默认为“Echo:｛message｝”。

配置克劳德桌面/Claude代码

将服务器配置添加到 mcpServers 配置文件中的部分。

使用。NET工具

要求。NET 10 SDK。这种方法在首次使用时自动下载工具，并在后续运行时更新到最新版本。

"echo": {
  "command": "dotnet",
  "args": [
    "tool",
    "exec",
    "-y",
    "ave.mcpserver.echo"
  ],
  "env": {
    "MessageFormat": "Claude says: {message}"
  }
}

使用全局安装

要求。NET 10 SDK。安装一次工具，然后直接使用。

dotnet tool install --global Ave.McpServer.Echo

"echo": {
  "command": "ave-mcpserver-echo",
  "env": {
    "MessageFormat": "Claude says: {message}"
  }
}

要更新，请执行以下操作： dotnet tool update --global Ave.McpServer.Echo

使用Docker

不需要。NET 10 SDK。

"echo": {
  "command": "docker",
  "args": [
    "run",
    "--rm",
    "-i",
    "-e", "MessageFormat=Claude says: {message}",
    "aadversteeg/echo-mcp-server:latest"
  ]
}

使用带有自定义配置文件的Docker

要使用主机系统中的自定义配置文件，请执行以下操作：

1. 在您的主机上创建自定义配置文件（例如。， echo-appsettings.json):

{
  "MessageFormat": "My Custom Format: {message}",
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft": "Warning"
    }
  }
}

1. 更新配置以装载此文件：

"echo": {
  "command": "docker",
  "args": [
    "run",
    "--rm",
    "-i",
    "-v", "C:/path/to/echo-appsettings.json:/app/appsettings.json",
    "aadversteeg/echo-mcp-server:latest"
  ]
}

重要提示：

• 启动容器之前，主机系统上必须存在配置文件
• 您可以在主机上使用任何文件名（例如。， echo-appsettings.json)，但必须安装到 /app/appsettings.json 容器内部
• 确保路径适合您的操作系统（Windows使用反斜杠或正斜杠，Linux/macOS使用正斜杠）
• 更改配置文件后，重新启动Claude Desktop以应用更改

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。