声 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 文件。