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. 初始化成功

初始化成功的通知 JSON 格式如下：

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

3. 网络状态查询（Ping）

使用以下 JSON 格式进行网络状态查询：

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

4. 列出工具

列出工具的请求 JSON 格式如下：

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

5. 调用工具：Add

调用 Add 工具的 JSON 格式如下：

{
  "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 工具并模拟错误的 JSON 格式如下：

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