MCP Ts Starter

🚀 你好 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. 在另一個終端窗口中，發送請求以調用回聲工具：

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 - 列出所有可用工具和方法

提示

無。

故障排除

無。

許可證

無。