使用说明
项目简介
Echo MCP服务器是一个实现了Model Context Protocol (MCP) 的简单服务器,其核心功能是将接收到的任何消息原样返回(回显)。这个服务器主要用于帮助开发者测试和验证 MCP 客户端的功能,例如客户端与服务器的连接、消息发送和接收等。由于其功能简单直接,非常适合作为MCP客户端开发的早期测试环境。
主要功能点
- 消息回显: 接收客户端发送的任何文本消息,并将其原封不动地返回。
- 支持多种消息类型: 能够处理空消息、特殊字符、表情符号和长消息等各种类型的文本输入。
- 提供 Echo 工具: 注册了一个名为 'echo' 的工具,客户端可以调用此工具来发送消息并接收回显。
安装步骤
- 克隆仓库: 首先,你需要将 Echo MCP 服务器的仓库克隆到本地:
git clone https://github.com/Garoth/echo-mcp.git cd echo-mcp - 安装依赖: 进入仓库目录后,使用 npm 安装项目依赖:
npm install - 构建项目: 执行构建命令,编译 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 服务器的回显功能。
信息
分类
开发者工具