建设银行办信用卡网站首页高埗网站建设

建设银行办信用卡网站首页,高埗网站建设,承德seo搜索推广,一键配置wordpress目录 一、协议本质#xff1a;JSON-RPC 2.0 约定 核心组成 1. JSON-RPC 2.0 基础 二、协议消息全集#xff08;核心内容#xff09; 1. 初始化消息#xff08;初始化握手#xff09; 2. 工具相关消息 3. 资源相关消息 4. 通知消息#xff08;服务器主动推送JSON-RPC 2.0 约定核心组成1. JSON-RPC 2.0 基础二、协议消息全集核心内容1. 初始化消息初始化握手2. 工具相关消息3. 资源相关消息4. 通知消息服务器主动推送三、协议传输层支持两种传输方式STDIO 通信示例四、协议中的核心概念1. 工具Tools规范2. 资源Resources规范3. 内容Content类型五、完整通信流程示例完整会话示例六、协议的错误处理错误响应格式常见错误码七、协议扩展性扩展字段能力协商八、实际实现示例Python 实现片段完整通信追踪九、协议设计哲学为什么这样设计与其他协议对比十、总结MCP 协议是什么MCP 协议是Model Context Protocol​ 的规范定义了 LLM 与工具之间的标准通信方式。一、协议本质JSON-RPC 2.0 约定核心组成MCP 协议 JSON-RPC 2.0 基础协议 特定消息约定 传输约定1. JSON-RPC 2.0 基础每个消息都是这样的 JSON{ jsonrpc: 2.0, // 必填版本标识 id: 1, // 请求ID用于匹配响应 method: tools/list, // 方法名 params: {...} // 参数 }响应格式{ jsonrpc: 2.0, id: 1, // 与请求的 id 对应 result: {...} // 成功结果 // 或 error: {...} // 错误信息 }二、协议消息全集核心内容1. 初始化消息初始化握手客户端 → 服务器{ jsonrpc: 2.0, id: 1, method: initialize, params: { protocolVersion: 2024-11-05, capabilities: { roots: { listChanged: true }, tools: {}, resources: {} }, clientInfo: { name: claude, version: 1.0.0 } } }服务器响应{ jsonrpc: 2.0, id: 1, result: { protocolVersion: 2024-11-05, capabilities: { tools: {}, resources: {} }, serverInfo: { name: weather-server, version: 1.0.0 } } }2. 工具相关消息列出工具// 请求 { jsonrpc: 2.0, id: 2, method: tools/list } // 响应 { jsonrpc: 2.0, id: 2, result: { tools: [ { name: get_weather, description: 获取天气信息, inputSchema: { type: object, properties: { city: {type: string}, unit: {enum: [celsius, fahrenheit]} }, required: [city] } } ] } }调用工具// 请求 { jsonrpc: 2.0, id: 3, method: tools/call, params: { name: get_weather, arguments: { city: 北京, unit: celsius } } } // 响应 { jsonrpc: 2.0, id: 3, result: { content: [ { type: text, text: 北京天气晴25°C湿度 60% }, { type: image, data: base64..., mimeType: image/png } ], isError: false } }3. 资源相关消息列出资源// 请求 { jsonrpc: 2.0, id: 4, method: resources/list } // 响应 { jsonrpc: 2.0, id: 4, result: { resources: [ { uri: file:///reports/q4.md, name: Q4 报告, description: 第四季度财务报告, mimeType: text/markdown } ] } }读取资源// 请求 { jsonrpc: 2.0, id: 5, method: resources/read, params: { uri: file:///reports/q4.md } } // 响应 { jsonrpc: 2.0, id: 5, result: { contents: [ { uri: file:///reports/q4.md, mimeType: text/markdown, text: # Q4 财务报告\n\n收入...\n利润... } ] } }4. 通知消息服务器主动推送资源变更通知{ jsonrpc: 2.0, method: notifications/resources/updated, params: { resources: [ { uri: file:///reports/q4.md, changed: true } ] } }进度通知{ jsonrpc: 2.0, method: notifications/progress, params: { progressToken: abc123, progress: 0.5, total: 100 } }三、协议传输层支持两种传输方式1. 标准输入输出STDIO客户端进程 │ ├─STDIN───┐ │ ▼ │ 服务器进程 │ ▲ └─STDOUT──┘通过管道通信一行一个 JSON 消息用换行符分隔2. HTTP Server-Sent EventsSSE客户端 ──HTTP POST──▶ 服务器 │ │ │◀──SSE 流───────────│ │ │ └──HTTP POST───▶ │ (调用工具) │STDIO 通信示例# 服务器读取消息 import sys import json def read_message(): line sys.stdin.readline() if not line: return None return json.loads(line) def send_message(msg): json.dump(msg, sys.stdout) sys.stdout.write(\n) sys.stdout.flush() # 客户端发送 echo {jsonrpc:2.0,id:1,method:initialize,params:{...}} | python server.py四、协议中的核心概念1. 工具Tools规范{ name: tool_name, // 工具标识全局唯一 description: ..., // 给 LLM 看的描述 inputSchema: { // JSON Schema type: object, properties: { param1: {type: string} }, required: [param1] } }2. 资源Resources规范{ uri: scheme://path, // 统一资源标识符 name: 显示名称, description: ..., // 资源描述 mimeType: text/plain // 内容类型 }3. 内容Content类型{ content: [ { type: text, // 文本内容 text: Hello World }, { type: image, // 图片 data: base64..., mimeType: image/png }, { type: resource, // 引用其他资源 resource: { uri: file:///doc.md, mimeType: text/markdown } } ] }五、完整通信流程示例完整会话示例// 1. 初始化 客户端 → {jsonrpc:2.0,id:1,method:initialize,params:{...}} 服务器 ← {jsonrpc:2.0,id:1,result:{...}} // 2. 列出工具 客户端 → {jsonrpc:2.0,id:2,method:tools/list} 服务器 ← {jsonrpc:2.0,id:2,result:{...}} // 3. 调用工具 客户端 → {jsonrpc:2.0,id:3,method:tools/call,params:{...}} 服务器 ← {jsonrpc:2.0,id:3,result:{...}} // 4. 资源变更通知服务器主动 服务器 ← {jsonrpc:2.0,method:notifications/resources/updated,params:{...}} // 5. 列出资源 客户端 → {jsonrpc:2.0,id:4,method:resources/list} 服务器 ← {jsonrpc:2.0,id:4,result:{...}}六、协议的错误处理错误响应格式{ jsonrpc: 2.0, id: 123, error: { code: -32601, // JSON-RPC 标准错误码 message: Method not found, data: { // MCP 扩展信息 type: INVALID_TOOL, details: Tool xyz not found } } }常见错误码错误码含义场景-32600无效请求JSON 格式错误-32601方法不存在调用未定义的方法-32602无效参数参数不符合 schema-32700解析错误JSON 解析失败-32000服务器错误工具执行异常七、协议扩展性扩展字段{ jsonrpc: 2.0, id: 1, method: tools/call, params: {...}, annotations: { // 扩展字段 auth: {token: ...}, trace: {id: abc123} } }能力协商{ capabilities: { tools: { listChanged: true, // 支持工具变更通知 callParallel: true // 支持并行调用 }, resources: { subscribe: true, // 支持资源订阅 listChanged: true }, prompts: {} // 提示词能力 } }八、实际实现示例Python 实现片段import json import sys import asyncio from typing import Dict, Any class MCPServer: def __init__(self, name: str): self.name name self.tools {} self.resources {} async def handle_message(self, msg: Dict[str, Any]) - Dict[str, Any]: method msg.get(method) if method initialize: return { jsonrpc: 2.0, id: msg[id], result: { protocolVersion: 2024-11-05, serverInfo: {name: self.name} } } elif method tools/list: return { jsonrpc: 2.0, id: msg[id], result: { tools: [ { name: echo, description: Echo input, inputSchema: { type: object, properties: { text: {type: string} } } } ] } } elif method tools/call: tool_name msg[params][name] arguments msg[params][arguments] if tool_name echo: return { jsonrpc: 2.0, id: msg[id], result: { content: [{ type: text, text: arguments.get(text, ) }] } }完整通信追踪# 启动服务器 $ python simple_server.py # 通信过程STDIO 发送: {jsonrpc:2.0,id:1,method:initialize,params:{...}} 接收: {jsonrpc:2.0,id:1,result:{...}} 发送: {jsonrpc:2.0,id:2,method:tools/list} 接收: {jsonrpc:2.0,id:2,result:{tools:[...]}} 发送: {jsonrpc:2.0,id:3,method:tools/call,params:{...}} 接收: {jsonrpc:2.0,id:3,result:{content:[...]}}九、协议设计哲学为什么这样设计基于 JSON-RPC 2.0成熟标准广泛支持请求-响应模型简单良好的错误处理STDIO 传输语言无关性简单可靠无需网络配置声明式工具定义LLM 可理解工具用途运行时发现能力类型安全输入资源概念统一数据访问变更通知机制内容协商能力与其他协议对比协议特点与 MCP 的区别OpenAI Function Calling​函数调用供应商绑定MCP 是开放协议gRPC​高性能 RPC复杂MCP 更简单JSON 友好REST API​HTTP 资源操作MCP 是 LLM 专用协议LSP​编辑器语言服务类似理念不同领域十、总结MCP 协议是什么MCP 协议是一套规范定义了 LLM 如何与外部工具通信基于 JSON-RPC 2.0使用成熟的 RPC 标准传输无关支持 STDIO 和 HTTP/SSE声明式工具和资源有明确的 schema双向通信客户端调用工具服务器主动通知扩展性强支持多种内容类型和扩展字段简单说MCP 协议 JSON 消息格式 通信约定 工具定义规范核心价值标准化 LLM 工具调用实现工具的动态发现提供安全的执行环境支持丰富的返回类型这就是为什么说 MCP Server 是遵循 MCP 协议的进程——它必须按照这个规范接收和发送 JSON 消息才能与 Claude 等 LLM 应用正常通信。