使用说明

项目简介

Echo MCP服务器是一个实现了Model Context Protocol (MCP) 的简单服务器,其核心功能是将接收到的任何消息原样返回(回显)。这个服务器主要用于帮助开发者测试和验证 MCP 客户端的功能,例如客户端与服务器的连接、消息发送和接收等。由于其功能简单直接,非常适合作为MCP客户端开发的早期测试环境。

主要功能点

  • 消息回显: 接收客户端发送的任何文本消息,并将其原封不动地返回。
  • 支持多种消息类型: 能够处理空消息、特殊字符、表情符号和长消息等各种类型的文本输入。
  • 提供 Echo 工具: 注册了一个名为 'echo' 的工具,客户端可以调用此工具来发送消息并接收回显。

安装步骤

  1. 克隆仓库: 首先,你需要将 Echo MCP 服务器的仓库克隆到本地:
    git clone https://github.com/Garoth/echo-mcp.git
    cd echo-mcp
  2. 安装依赖: 进入仓库目录后,使用 npm 安装项目依赖:
    npm install
  3. 构建项目: 执行构建命令,编译 TypeScript 代码到 JavaScript:
    npm run build

服务器配置

要让 MCP 客户端(例如 Cline)连接到 Echo MCP 服务器,你需要在客户端的 MCP 服务器设置中添加以下配置。以 VSCode 的 Cline 客户端为例,你需要编辑 Cline MCP 设置文件 'cline_mcp_settings.json',通常位于 '~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/' 目录下。

在 'mcpServers' 字段中添加一个新的服务器配置项,配置内容如下:

{
  "mcpServers": {
    "echo-server": {
      "command": "node",
      "args": ["/path/to/echo-server/build/index.js"],
      "disabled": false,
      "autoApprove": [
        "echo"
      ]
    }
  }
}

配置参数说明:

  • '"echo-server"': 服务器名称,可以自定义,用于在客户端中标识该服务器。
  • '"command": "node"': 启动服务器的命令,这里使用 Node.js 运行时环境。
  • '"args": ["/path/to/echo-server/build/index.js"]': 启动命令的参数,指向 Echo MCP 服务器构建后的入口文件 'index.js'。请将 '/path/to/echo-server' 替换为你的本地 Echo MCP 服务器仓库的绝对路径。 例如,如果你的仓库在 '/Users/yourusername/echo-mcp',则应将 '/path/to/echo-server' 替换为 '/Users/yourusername/echo-mcp'。
  • '"disabled": false': 表示服务器启用状态,设置为 'false' 表示启用。
  • '"autoApprove": ["echo"]': 自动批准的工具列表,这里设置为 '["echo"]' 表示自动允许客户端调用 'echo' 工具,无需手动批准。

基本使用方法

配置完成后,在 MCP 客户端中选择 "echo-server",客户端将通过标准输入输出 (stdio) 与 Echo MCP 服务器建立连接。

客户端可以调用服务器提供的 'echo' 工具来发送消息。例如,在 Cline 客户端中,你可以通过类似以下的请求调用 'echo' 工具:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "callTool",
  "params": {
    "name": "echo",
    "arguments": {
      "message": "你好,世界!"
    }
  }
}

服务器收到请求后,会调用 'echo' 工具,并将 'arguments.message' 中的消息 "你好,世界!" 原样返回给客户端。客户端将收到包含相同消息的响应。

你可以尝试发送不同类型的消息,包括特殊字符、表情符号和长消息,来测试 Echo MCP 服务器的回显功能。

信息

分类

开发者工具