文档建议反馈控制台
首页
学习
活动
专区
圈层
工具
MCP广场
文章/答案/技术大牛
发布

MCP规范完整中译稿：2025-3-26版

如果服务器不能接受输入，它必须返回一个 HTTP 错误状态码 (例如，400 Bad Request)。HTTP 响应的正文可能包含一个没有 id 的 JSON-RPC 错误响应。...服务器不应该在为每个接收到的 JSON-RPC 请求发送一个 JSON-RPC 响应之前关闭 SSE 流，除非会话过期。 在发送了所有 JSON-RPC 响应之后，服务器应该关闭 SSE 流。...对于常见的失败情况，客户端应该返回标准的 JSON-RPC 错误： 客户端不支持 root:-32601 (未找到方法) 内部错误：-32603 错误示例： {   "jsonrpc": "2.0",...6.2.6 错误处理 对于常见的故障情况，服务器应该返回标准的 JSON-RPC 错误： 无效提示词名称：-32602 (Invalid params) 缺少所需参数： -32602 (Invalid...6.3.7 错误处理 对于常见的故障情况，服务器应该返回标准的 JSON-RPC 错误： 未找到资源：-32002 内部错误：-32603 错误示例： {   "jsonrpc": "2.0",   "

5K11

10分钟掌握 JSON-RPC 协议，面试加分、设计不踩坑

批量处理能力：2.0 版本支持在单个请求中包含多个 RPC 调用，服务端返回结果数组。 双向通信：通过长连接和通知机制，JSON-RPC 也支持服务端主动向客户端推送消息。...响应对象结构 响应对象是服务端返回给客户端的执行结果： // 成功响应 { "jsonrpc": "2.0", "result": 19, "id": 1 } // 错误响应 { "jsonrpc":...批量调用与性能优化 批量请求机制 JSON-RPC 2.0 支持在单个请求中发送多个 RPC 调用，服务端返回相应的响应数组。这一机制在高并发场景下可以减少网络往返次数。...如果批量请求中的所有请求都是通知，服务端不需要返回任何响应。其他情况下，即使某些请求处理失败，响应数组中仍应包含对应请求的错误响应。...方法白名单：仅暴露必要的方法，对未公开的方法返回 -32601 错误。 日志与监控：记录详细的请求日志，监控异常模式，及时发现潜在攻击。

15210
    • 您找到你想要的搜索结果了吗？
    是的
    没有找到

    golang源码分析：jsonrpc（1）

    JSON-RPC 目前有两个主要版本：1.0 和 2.0。2.0 版本在1.0的基础上进行了改进，包括更严格的错误处理和更清晰的规范定义。...SON-RCP错误处理：JSON-RPC 错误响应包含一个error字段，该字段是一个对象，包含以下字段： code: 必须为整数，表示错误代码。 message: 必须为字符串，表示错误信息。...data: 可选字段，包含错误的详细数据。 错误代码 JSON-RPC 定义了一些标准的错误代码： -32700: 解析错误，JSON 解析失败。 -32600: 无效的请求，请求格式不正确。...-32603: 内部错误，服务器内部错误。 -32000 到 -32099: 服务器错误，服务器定义的错误。...其实我们按照json-rpc协议的规范来进行传参数和返回值，并使用json格式进行序列化传输，就可以实现json-rpc协议，作为gopher我们不需要自己实现，net/rpc/jsonrpc已经包含了完整的实现

    9810

    压力测试和JMeter使用分析

    1、性能指标   响应时间（Response Time: RT） 响应时间指用户从客户端发起一个请求开始，到客户端接收到从服务器端返回的响 应结束，整个过程所耗费的时间。...最少响应时间（Mininum ResponseTime） 指用户发出请求或者指令到系统做出反应（响 应）的最少时间。  ...90%响应时间（90% Response Time） 是指所有用户的响应时间进行排序，第 90%的响应时间。...响应时间：服务处理一个请求或一个任务的耗时。         错误率：一批请求中结果出错的请求所占比例。  ...添加 HTTP 请求  添加监听器  启动压测&查看分析结果  结果分析  有错误率同开发确认，确定是否允许错误的发生或者错误率允许在多大的范围内；  Throughput 吞吐量每秒请求的数大于并发数

    1.7K20

    在 Go 中使用 Aira2

    错误处理在与 Aria2 进行交互的过程中，可能会遇到各种类型的错误。这些错误可能来自于网络通信问题、JSON-RPC 请求格式错误、Aria2 返回的错误信息等。...JSON-RPC 请求格式错误: 可能由于构建 JSON-RPC 请求时参数错误或格式不正确等原因导致请求失败。...Aria2 返回的错误信息: 当 Aria2 处理请求时出现错误，例如任务不存在、参数错误等，会返回相应的错误信息。如何处理这些错误？...如果是其他格式错误，可以输出错误信息进行调试。Aria2 返回的错误信息: 当收到 Aria2 返回的错误信息时，可以根据错误信息的内容来确定错误的原因，并采取相应的措施。...如果是 Aria2 返回的错误信息，则直接输出错误信息进行调试。通过这样的错误处理方式，我们可以有效地应对各种可能遇到的错误，提高程序的健壮性和稳定性。

    89810

    JSON-RPC 2.0 规范(中文版)

    3.兼容性 JSON-RPC 2.0 的请求对象和响应对象可能无法在现用的JSON-RPC 1.0 客户端或服务端工作，然而我们可以很容易在两个版本间区分出2.0，总会包含一个成员命名为 “jsonrpc...由于通知没有返回的响应对象，所以通知不确定是否被定义。同样，客户端不会意识到任何错误（例如参数缺省，内部错误）。...5.1错误对象 当一个rpc调用遇到错误时，返回的响应对象必须包含错误成员参数，并且为带有下列成员参数的对象： code 使用数值表示该异常的错误类型。 必须为整数。...-32603 Internal error内部错误 JSON-RPC内部错误。 -32000 to -32099 Server error服务端错误 预留用于自定义的服务器错误。...若批量调用没有需要返回的响应对象，则服务端不需要返回任何结果且必须不能返回一个空数组给客户端。

    5.8K20

    MCP协议深度解析：客户端-服务器架构的技术创新

    JSON-RPC 2.0通信机制深度解析2.1 JSON-RPC 2.0协议基础MCP协议基于JSON-RPC 2.0规范构建其通信层，这一选择体现了协议设计者对成熟标准的重视。...JSON-RPC 2.0提供了轻量级、无状态的远程过程调用机制。...MCP协议定义了标准化的错误处理机制：// MCP标准错误代码const MCP_ERROR_CODES = { // JSON-RPC标准错误 PARSE_ERROR: -32700, INVALID_REQUEST...// 工具元数据定义 getDefinition() { return { name: "database_query", description: "执行SQL查询并返回结果...通过详细的性能测试和实际部署经验，我们可以看到MCP在响应时间、吞吐量、并发处理等关键指标上都显著优于传统API集成方式，这为企业级应用提供了坚实的技术基础。

    1K10

    我与大模型的API困境：MCP如何打破孤立与重构连接

    一、 大模型的API时代：连接之痛还记得ChatGPT刚开放API那段时间吗？整个技术圈都在狂欢。开发者们像发现新大陆一样，疯狂地构建着各种应用——从简单的对话机器人到复杂的AI Agent系统。...GPT的Function Calling、Claude的Tool Use、Gemini的Function Declarations，看似功能相近，但参数定义、返回格式、错误处理各不相同。...首先是JSON-RPC 2.0的选择。 MCP使用JSON-RPC作为底层通信协议，这看起来是个保守的选择——为什么不选gRPC或者GraphQL？但仔细想想，这个决定非常聪明。...坑二：错误处理的复杂性。 当Server发生错误时，模型需要能够理解错误原因，并给出有用的反馈给用户。但MCP的错误信息是技术性的，普通用户根本看不懂。...我们通过在Server层面实现智能缓存机制，预测模型可能的查询需求，提前加载数据，才将响应时间降到了可接受的范围。

    25310

    别等系统“凉了”才响铃：聊聊延迟敏感系统的监控与报警设计

    这在延迟敏感系统里，是致命认知错误。二、什么叫延迟敏感系统？...别只盯“平均值”一句话定义：用户或下游系统，对响应时间极其敏感的系统但这里有一个巨坑：平均延迟（avglatency）几乎没啥用举个真实又残酷的例子：90%请求：20ms9%请求：200ms1%请求：5...一次请求的延迟，往往长这样：展开代码语言：TXTAI代码解释入口→网关→服务A→MQ→服务B→存储→返回你只盯“总耗时”，等报警了你只会懵：“慢了，但慢在哪？”所以监控设计要拆链路。...五、报警不是越多越好，是“该响才响”说句得罪人的话：80%的报警系统，最后都会被静音为什么？...半夜响白天响周末响啥都响还经常是误报最后的结局就是：真正出事的时候，大家已经对报警免疫了我自己总结的报警三原则：原则一：报警要“贴业务”不要只报：“P99延迟>2s”而是：“支付接口P99延迟>2s，影响订单成功率

    24710

    揭开性能测试的神秘面纱

    我们通常会关注如下数据指标 可用性：系统在面对异常时可以提供正常服务的能力 QPS（Queries-per-second，每秒查询率）：QPS是对一个特定的查询服务器在规定时间内所处理流量多少的衡量标准 平响（...平均响应时间）：所有请求平均耗费的时间 并发数：并发用户数是指系统可以同时承载的正常使用系统功能的用户的数量。...并发数=QPS*平均响应时间 PV（Page View）：即页面浏览量或点击量，用户每次对网站的访问均被记录，用户对同一页面的多次访问，访问量累计 错误码：接口返回结果的HTTP状态码 吞吐率：单位时间内服务器处理的请求数来描述其并发处理能力...，基本是在100 ms 下图为PV，有时候还会采集PV lost数据指标，PV lost是对服务器日志中的status为500状态码的日志做采集 错误码，正常接口返回错误码是200，下图当中有少量499...、404、504的错误码 调优阶段 当我们在性能测试的指标发现异常后（如监控平台报警，错误码返回5xx等），就需要与开发配合，让开发优化代码修复性能问题 根据定位到的瓶颈点针对性解决，包括应用性能调优

    61210

    ACP 协议设计哲学 —— 为什么 OpenClaw 选择自研 Agent Client Protocol

    关键词：ACP｜Agent Client Protocol｜JSON-RPC 扩展｜TypeBox｜流式通信｜多端同步 在构建一个支持 WhatsApp、Telegram、Web、iOS、Android...OpenClaw 没有采用现成的 gRPC、GraphQL 或 REST，而是基于 JSON-RPC 2.0 扩展出一套专为 AI Agent 场景定制的轻量级协议——ACP（Agent Client...基础结构：兼容 JSON-RPC 2.0 所有请求遵循标准格式： { "jsonrpc": "2.0", "method": "chat.send", "params": { /* ......常见事件类型： assistant.text.delta：AI 生成文本片段 tool.call.request：AI 请求调用工具（如 bash_exec） tool.call.result：工具执行结果返回...错误模型标准化 ACP 定义统一错误码： { "jsonrpc": "2.0", "error": { "code": -32001, "message": "Model context

    1.2K10

    探究EVM全节点与存档节点的不同

    默认的返回状态和 Missing trie node的错误 根据所访问的链和所使用的客户端，被限制能访问多少个可用的区块状态有所不同： 以太坊：128 个区块 Polygon: 128 个区块 BNB...Harmony: 128 个区块 如果你试图查询一个不能从全节点访问的区块，你会收到一个missing trie node的错误。...一般来说，收到missing trie node的错误意味着你需要一个存档节点。 存档节点 存储所有保存在全节点中的东西，并建立一个历史状态的档案。 他们是配置为在存档模式下运行的全节点。...在一个全节点上运行这段代码将返回一个错误，因为我们获取区块高度 1[21]时一个地址的余额： from web3 import Web3 node_url = "CHAINSTACK_ARCHIVE_NODE_URL...eth_getStorageAt 返回一个给定地址的存储位置的值，详情请见以太坊 Wiki eth_getStorageAt[30]。 下面的例子将返回简单存储合约[31]的存储值。

    1.9K20

    以太坊中GraphQL简介及使用

    API返回数据往往是前后端协商定义的，而后端为了满足不同的客户端，减小后端请求的复杂性，往往会给出一些冗余数据。GraphQL很强大的一个功能就是能够指定所需要的API数据并获得可预测的结果。...GraphQL 使用类型来保证应用只请求可能的数据，还提供了清晰的辅助性错误信息。应用可以使用类型，而避免编写手动解析代码。...2、为了返回数据全面而额外增加资源消耗 例如，我们在调用eth_getBlock时会返回totalDifficulty字段，而该字段与块头是分开存储，需要单独读取磁盘，许多调用者不需要此字段，但是RPC...针对JSON-RPC的这些不足，有的同学会说，那我通过修改JSON-RPC的接口，也可以避免上边的问题，但是这样增加接口的复杂性。而API查询语言GraphQL就能很好的解决上边的问题。...的向后兼容 GraphQL实现了JSON-RPC节点接口提供的大部分只读功能。

    1.8K10

    go-zero v1.8.3全方位解析 —— Model Context Protocol大升级，打造AI实时交互新体验！

    全面升级的协议支撑 版本升级完善了MCP协议的初始化流程、能力协商机制及错误报告方案。包括对JSON-RPC请求的标准支持及响应处理，错误码规范化确保开发调试体验流畅，保障系统稳定性。...JSON-RPC的完整实现与错误治理 作为AI交互请求的标准协议，JSON-RPC的完整实现涵盖请求解析、语义校验、业务路由和响应格式化等环节。...对于工具执行错误、参数缺失或格式不对等问题，SDK提供了细致的错误反馈，简化调试过程，提升接口调用的鲁棒性。 3....高度可定制的工具与Prompt体系 支持工具的schema验证、超时执行控制、灵活返回多种结果类型（文本、JSON、图像等）。...复杂业务实时监控 通过JSON-RPC消息体系和SSE通信，业务监控平台可实现实时事件推送，工具系统可针对异常自动执行纠偏操作，提升运维智能水平与响应速度。

    77810

    MySQL日志文件之错误日志和慢查询日志详解

    错误日志(Error log) 慢查询日志(Slow query log) 二进制日志 查询日志 二、错误日志详解：MySQL错误日志是记录MySQL 运行过程中较为严重的警告和错误信息，以及MySQL...【查看MySQL数据库错误日志存放的位置】 ?...三、慢查询日志详解：MySQL慢查询日志是MySQL提供的一种日志记录，它用来记录在MySQL中响应时间超过阀值的语句，具体指SQL语句运行时间超过long_query_time值的SQL，则会被记录到慢查询日志文件中...但是默认情况下，MySQL数据库并不启动慢查询日志，需要我们手动来设置这个参数，当然，如果不是调优需要的话，一般不建议启动该参数，因为开启慢查询日志会或多或少带来一定的性能响。

    3.5K80

    如何把thrift rpc转换为http

    JSONRPC JSON-RPC是一个无状态且轻量级的远程过程调用(RPC)协议。它允许运行在基于socket,http等诸多不同消息传输环境的同一进程中。...另外，由于JSON-RPC 1.0 的通知使用了空值，这可能引起处理上的混淆。 [2] 使用小数是不确定性的，因为许多十进制小数不能精准的表达为二进制小数。...通知 没有包含“id”成员的请求对象为通知， 作为通知的请求对象表明客户端对相应的响应对象并不感兴趣，本身也没有响应对象需要返回给客户端。服务端必须不回复一个通知，包含那些批量请求中的。...由于通知没有返回的响应对象，所以通知不确定是否被定义。同样，客户端不会意识到任何错误（例如参数缺省，内部错误）。...错误对象 当一个rpc调用遇到错误时，返回的响应对象必须包含错误成员参数，并且为带有下列成员参数的对象： code 使用数值表示该异常的错误类型。 必须为整数。

    3.6K20
    点击加载更多

    相关资讯

    热门标签

    更多标签

    活动推荐

      运营活动

      活动名称
      广告关闭

      腾讯云开发者

      扫码关注腾讯云开发者

      扫码关注腾讯云开发者

      领取腾讯云代金券

      热门产品

      热门推荐

      更多推荐

      Copyright © 2013 - 2026 Tencent Cloud. All Rights Reserved. 腾讯云 版权所有

      深圳市腾讯计算机系统有限公司 ICP备案/许可证号：粤B2-20090059 粤公网安备44030502008569号

      腾讯云计算（北京）有限责任公司 京ICP证150476号 | 京ICP备11018762号

      领券