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"}}}