MCP Example And Demo

🚀 在 STDIN 上運行示例

本示例展示瞭如何在 STDIN 上運行相關服務，並給出了一系列操作的請求示例。

🚀 快速開始

運行服務器

運行服務器可使用以下命令：

mcp run server.py

💻 使用示例

基礎用法

1. 初始化請求

初始化請求的 JSON 格式如下：

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2025-03-26",
    "capabilities": {
      "roots": {
        "listChanged": true
      },
      "sampling": {}
    },
    "clientInfo": {
      "name": "ExampleClient",
      "version": "1.0.0"
    }
  }
}

⚠️ 重要提示

注意：此請求必須在一行中發送，如下所示：

{"jsonrpc": "2.0", "id": 1, "method": "initialize", "params": {"protocolVersion": "2025-03-26", "capabilities": {"roots": {"listChanged": true}, "sampling": {}}, "clientInfo": {"name": "ExampleClient", "version": "1.0.0"}}}

2. 初始化成功

初始化成功的通知請求如下：

{"jsonrpc": "2.0", "method": "notifications/initialized" }

3. 網絡狀態查詢（Ping）

查詢網絡狀態的請求如下：

{"jsonrpc": "2.0", "id":"123", "method":"ping"}

4. 列出工具

列出工具的請求如下：

{"jsonrpc" :"2.0", "id" :1, "method" :"tools/list"}

5. 調用工具：Add

調用 Add 工具的請求如下：

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "add",
    "arguments": {
      "a": 40,
      "b": 2
    }
  }
}

同樣，此請求也可在一行中發送：

{"jsonrpc": "2.0", "id": 2, "method": "tools/call", "params": {"name": "add", "arguments": {"a": 40 ,"b": 2}}}

6. 調用工具：Add，帶有錯誤

調用 Add 工具並傳入錯誤參數的請求如下：

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "add",
    "arguments": {
      "a": 40,
      "z": "2"
    }
  }
}

此請求也可在一行中發送：

{"jsonrpc": "2.0", "id": 2, "method": "tools/call", "params": {"name": "add", "arguments": {"a": 40 ,"z": "2"}}}