MCP Ts Starter

🚀 你好 MCP 世界服务器

本项目是一个用 TypeScript 实现的简单 Model Context Protocol (MCP) 服务器，它演示了基本的 MCP 功能，涵盖资源、提示和工具等方面，具有一定的实用性和参考价值。

🚀 快速开始

先决条件

• 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 模式运行服务器，适用于命令行集成。

✨ 主要特性

• 支持 SSE 和 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. 在另一个终端窗口中，发送请求以调用回声工具：

   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. 使用调试工具查看所有可用服务器方法：

   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. 在 MCP 检查器中连接到 http://localhost:3000/sse
2. 可用资源和工具
3. 交互式地调用工具

📚 详细文档

服务器 API

资源

• hello://world - 静态的“你好，世界”资源
• greeting://{name} - 带有名称参数的动态问候

工具

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

提示

无。

故障排除

无。

许可证

无。