MCP回声服务器

一个基于C#的最小化MCP协议服务器,提供文本转换工具、资源访问和工作流提示功能,适用于VS Code等MCP兼容客户端的集成开发环境。

  • by StephenDryden
  • C#
  • 本地部署
  • 更新于
在 GitHub 查看 stephendryden/mcp-server-echo

使用说明

MCP回声服务器(C#)

这是C#中的一个最小模型上下文协议(MCP)服务器,它公开了几个演示工具和一个工作流提示。

使用Docker构建和运行

  1. 构建Docker镜像:

    docker build -t mcp-echo-server .
    
  2. 运行服务器:

    docker run --rm -i mcp-echo-server
    

MCP集成

此服务器专为STDIO传输而设计,可以与任何兼容MCP的客户端集成,如VS Code或Claude Desktop。

VS代码集成: 确保您的 .vscode/mcp.json 包含:

{
   "servers": {
      "echo-server": {
         "type": "stdio",
         "command": "docker",
         "args": [
            "run",
            "--rm",
            "-i",
            "mcp-echo-server"
         ]
      }
   }
}

可用工具

工具

  • 回声:按原样返回输入文本。
  • 反向:返回反向输入文本。
  • 上部的:返回大写的输入文本。

资源

  • 示例文件资源:返回以下内容 sample.txt (包含在Docker镜像中)。

提示

  • 工作流提示:“要转换文本,请先回显,然后反转,然后使用可用工具转换为大写。”

MCP客户端可以使用此提示来指导工作流中的工具编排。

在Copilot聊天窗口中进行测试

您可以通过输入以下命令直接从Copilot聊天窗口测试工具和资源:

#echo hello world
#reverse hello world
#upper hello world

服务器将响应每个工具的预期输出。

要使用工作流提示,请让Copilot列出可用的提示或请求:

#mcp_echo-server_workflowPrompt

这验证了MCP回声服务器是否正在运行并与Copilot正确集成,并演示了工具、资源和提示用法。

Makefile使用情况

为方便起见,您可以使用提供的Makefile:

make build   # Build the Docker image

运作原理

运作原理

  • 服务器公开了三个MCP类:

    • 工具 (EchoTools):提供 echo, reverse,以及 upper 文本转换功能。
    • 提示 (EchoPrompts):提供工作流程指导,例如。, workflowPrompt 用于编排工具的使用。
    • 资源 (EchoResources):提供对静态文件的访问。, sampleFileResource 返回以下内容 sample.txt.
  • 您可以在聊天中直接调用工具(例如。, #echo hello world, #reverse hello world, #upper hello world).

  • 提示可以在聊天中访问(例如。, #workflowPrompt)指导工作流程。

  • 资源可以通过MCP资源浏览器或UI浏览,在聊天中可能无法直接调用。

  • 设计用于与MCP客户端和代理轻松集成和测试。

看 .vscode/mcp.json 了解集成细节。