Echo MCP Server

🚀 声 MCP 服务器

本项目是一个简单的基于 Model Context Protocol (MCP) 的回声服务器实现，通过 MCP 接口为用户提供基本的回显功能。

🚀 快速开始

回声 MCP 服务器使用 .NET Core 构建，并采用了 Model Context Protocol C# SDK（github.com/modelcontextprotocol/csharp-sdk）。它是一款轻量级工具，能将消息原样返回给客户端，展示了如何使用 MCP 创建具有简单功能的自定义服务器，可部署在本地机器或 Docker 容器中。

✨ 主要特性

• 可将任何消息回显给客户端。
• 支持通过配置自定义消息格式。
• 基于 Model Context Protocol 标准构建。

📦 安装指南

先决条件

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

开发构建说明

若要从源代码构建项目，可按以下步骤操作：

1. 克隆此仓库：

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

2. 切换到项目根目录：

cd echo-mcp-server

3. 使用以下命令构建项目：

dotnet build src/echo.sln

4. 运行测试：

dotnet test src/echo.sln

Docker 支持

手动构建 Docker 镜像

若要自己构建 Docker 镜像，可执行以下命令：

# 切换到仓库根目录
cd echo-mcp-server

# 构建 Docker 镜像
docker build -f src/Core.Infrastructure.McpServer/Dockerfile -t echo-mcp-server:latest src/

# 运行本地构建的镜像
docker run -d --name echo-mcp echo-mcp-server:latest

📚 详细文档

MCP 协议使用

客户端配置

若要在客户端上配置回声服务器，请将以下内容添加到你的 appsettings.json 文件中：

{
  "McpEchoOptions": {
    "Address": "tcp://localhost:5001"
  }
}

配置

环境变量

可通过设置以下环境变量来配置回声服务器的行为：

• ECHO_MESSAGE：要显示的自定义消息。
• ECHO_COLOR：消息的颜色（支持 ANSI 颜色代码）。

例如，要在控制台以红色显示“Hello, World!”，可执行以下命令：

docker run -e ECHO_MESSAGE="Hello, World!" -e ECHO_COLOR=31 echo-mcp-server:latest

文件配置

你还可以通过创建一个自定义的 appsettings.json 文件来配置服务器。例如：

{
  "McpEchoOptions": {
    "Message": "你好，世界！",
    "Color": "32"
  }
}

然后，在运行容器时挂载此文件：

docker run -v /path/to/custom-settings.json:/app/appsettings.json echo-mcp-server:latest

📄 许可证

该项目在 MIT License 下许可，详细信息见 LICENSE 文件。