MCP Ts Starter

Hello World MCP服务器

使用TypeScript构建的简单模型上下文协议（MCP）服务器实现。此服务器演示了基本的MCP功能，包括资源、提示和工具。

特性

• SSE和STDIO传输支持
• 静态和动态资源的资源处理
• 示例快速实施
• 回复消息的示例工具
• 服务器自检调试工具

入门指南

先决条件

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

安装

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

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

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

您应该看到这样的响应：

   event: endpoint
   data: /messages?sessionId=YOUR_SESSION_ID

1. 在另一个终端窗口中，发送调用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!"
         }
       }
     }'

1. 您应该在SSE终端窗口中看到响应：

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

1. 尝试调试工具查看可用的服务器方法：

   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检验员测试

对于可视化界面，您可以使用MCP检查器工具：

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

服务器应用程序接口

资源

• hello://world -静态hello world资源
• greeting://{name} -带有名称参数的动态问候语

工具

• echo -回显带有“Hello”前缀的消息
• debug -列出所有可用的工具和方法

鼓励

• helpful-assistant -一个基本的帮助助手提示

故障排除

• 如果您收到“邮件头已发送”错误，请确保您没有手动设置邮件头
• 会话ID处理对于正确的消息路由至关重要
• 检查服务器控制台以获取调试信息

许可证

麻省理工学院