📘 智能体 MCP JSON-RPC 接口文档#

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "方法名",
  "params": { ... }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": { ... }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32601,
    "message": "Method not found",
    "data": "附加错误信息（可选）"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2024-11-05",
    "capabilities": {},
    "clientInfo": {
      "name": "ClientName",
      "version": "1.0.0"
    }
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "serverInfo": {
      "name": "MCP Server",
      "version": "1.0.0"
    },
    "capabilities": {}
  }
}

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

{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "tools": [
      { "name": "calculator", "description": "Simple calculator" },
      { "name": "translator", "description": "Text translator" }
    ]
  }
}

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "calculator",
    "arguments": { "expression": "1+2*3" }
  }
}

{
  "jsonrpc": "2.0",
  "id": 3,
  "result": {
    "output": "7"
  }
}

{
  "jsonrpc": "2.0",
  "id": 4,
  "method": "resources/list",
  "params": {}
}

{
  "jsonrpc": "2.0",
  "id": 4,
  "result": {
    "resources": [
      { "id": "file1", "type": "text", "name": "example.txt" }
    ]
  }
}

{
  "jsonrpc": "2.0",
  "id": 5,
  "method": "resources/read",
  "params": {
    "resourceId": "file1"
  }
}

{
  "jsonrpc": "2.0",
  "id": 5,
  "result": {
    "content": "Hello World"
  }
}

{
  "jsonrpc": "2.0",
  "id": 6,
  "method": "prompts/list",
  "params": {}
}

{
  "jsonrpc": "2.0",
  "id": 6,
  "result": {
    "prompts": [
      { "id": "p1", "title": "Summarize text" }
    ]
  }
}

{
  "jsonrpc": "2.0",
  "id": 7,
  "method": "prompts/get",
  "params": { "id": "p1" }
}

{
  "jsonrpc": "2.0",
  "id": 7,
  "result": {
    "id": "p1",
    "content": "Please summarize the following text..."
  }
}