Hello World MCP Server

Hello World MCP 服务

使用 TypeScript 构建的简单 Model Context Protocol（MCP）服务实现。此服务演示了 MCP 的基本功能，包括资源、提示词和工具。

功能

• 支持 SSE 和 STDIO 传输
• 资源处理，支持静态和动态资源
• 示例提示词实现
• 回显消息的示例工具
• 用于服务自检的调试工具

开始使用

前提条件

• Node.js（v16 或更高版本）
• npm 或 yarn

安装

npm install

构建

npm run build

运行服务

HTTP/SSE 传输（Web 浏览器）

npm run start:http

这会在 http://localhost:3000 上启动服务，其中包含：

• 位于 /sse 的 SSE 端点
• 位于 /messages 的消息端点

STDIO 传输（命令行）

npm run start

这会以 stdio 模式运行服务，用于命令行集成。

测试服务

使用 cURL 测试

1. 启动 HTTP 服务：

   npm run start:http
   

2. 在终端窗口中连接到 SSE 端点：

   curl -N http://localhost:3000/sse
   

   你应该会看到类似这样的响应：

   event: endpoint
   data: /messages?sessionId=YOUR_SESSION_ID
   

3. 在另一个终端窗口中发送请求以调用 echo 工具：

   curl -X POST \
     "http://localhost:3000/messages?sessionId=YOUR_SESSION_ID" \
     -H 'Content-Type: application/json' \
     -d '{
       "jsonrpc": "2.0",
       "id": 1,
       "method": "tools/invoke",
       "params": {
         "name": "echo",
         "parameters": {
           "message": "Testing the MCP server!"
         }
       }
     }'
   

4. 你应该会在 SSE 终端窗口中看到响应：

   event: message
   data: {"jsonrpc":"2.0","id":1,"result":{"content":[{"type":"text","text":"Hello Testing the MCP server!"}]}}
   

5. 尝试使用 debug 工具查看可用的服务方法：

   curl -X POST \
     "http://localhost:3000/messages?sessionId=YOUR_SESSION_ID" \
     -H 'Content-Type: application/json' \
     -d '{
       "jsonrpc": "2.0",
       "id": 2,
       "method": "tools/invoke",
       "params": {
         "name": "debug",
         "parameters": {}
       }
     }'
   

使用 MCP Inspector 测试

如需使用可视化界面，可以使用 MCP Inspector 工具：

1. 在 MCP Inspector 中连接到 http://localhost:3000/sse
2. 浏览可用的资源和工具
3. 交互式调用工具

服务 API

资源

• hello://world - 静态的 Hello World 资源
• greeting://{name} - 使用名称参数的动态问候语

工具

• echo - 在消息前添加“Hello”并回显
• debug - 列出所有可用工具和方法

提示词

• helpful-assistant - 基本的助人助手提示词

故障排除

• 如果出现“Headers already sent”错误，请确保没有手动设置标头
• 会话 ID 的处理对于正确路由消息至关重要
• 查看服务控制台中的调试信息

许可证

MIT