【AI】mcp案例

MCP 协议操作流程示例（完整示例）

以下示例以查询“某天订单数量（query_orders）”为场景，演示 MCP 协议的完整五个步骤，包括初始化、工具发现、调用、返回结果和断开连接，并附带 OSM 场景示例。

1️⃣ 初始化连接（initialize）

客户端向服务器发送初始化请求：

{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"1.0","clientInfo":{"name":"my-mcp-client","version":"1.0.0"}}}

服务器响应：

{"jsonrpc":"2.0","id":1,"result":{"serverInfo":{"name":"order-mcp-server","version":"1.0.0"},"capabilities":{"tools":true,"resources":false}}}

2️⃣ 发送请求（获取工具列表）

客户端请求可用工具列表：

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

服务器响应：

{"jsonrpc":"2.0","id":2,"result":{"tools":[{"name":"query_orders","description":"查询订单数量","inputSchema":{"type":"object","properties":{"date":{"type":"string"}},"required":["date"]}}]}}

3️⃣ 处理请求（调用工具）

客户端发起工具调用：

{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"query_orders","arguments":{"date":"2026-04-09"}}}

服务器内部处理示意：

// 伪代码if(toolName.equals("query_orders")){Stringdate=args.get("date");intcount=db.query("SELECT COUNT(*) FROM orders WHERE date = ?",date);returncount;}

4️⃣ 返回结果

服务器返回处理结果：

{"jsonrpc":"2.0","id":3,"result":{"count":5231}}

模型最终回答：今天订单数是 5231

5️⃣ 断开连接

客户端主动关闭（本地进程 / socket）：

关闭进程或关闭 socket

WebSocket 关闭示例：

{"type":"close","code":1000,"reason":"normal closure"}

无状态 HTTP：每次请求独立，不需要显式断开。

🔁 整体流程串起来

1. initialize 2. tools/list 3. tools/call 4. 返回 result 5. 连接关闭