[{"data":1,"prerenderedAt":461},["ShallowReactive",2],{"integrations-zh:/zh/integrations/mcp":3},{"id":4,"title":5,"active":6,"body":7,"description":448,"extension":250,"eyebrow":449,"icon":450,"image":451,"meta":452,"name":453,"navTitle":453,"navigation":6,"order":454,"path":455,"seo":456,"slug":172,"status":457,"stem":458,"summary":459,"toc":451,"__hash__":460},"integrations_zh/zh/integrations/mcp.md","通用 MCP 客户端 + OpenPets",true,{"type":8,"value":9,"toc":431},"minimark",[10,107,131,189,229,277,314,372],[11,12,16,17,16,21,16,25,16,96],"section",{"id":13,"className":14},"overview",[15],"docs-section","\n  ",[18,19,20],"h2",{"id":20},"此集成的功能",[22,23,24],"p",{},"\n    通用 MCP 集成适用于任何能够启动 stdio MCP server 的助手或编辑器。无需使用专用的 OpenPets 设置流程，只需将 OpenPets MCP 命令添加到客户端的 MCP 配置中即可。\n  ",[26,27,30,31,16],"div",{"className":28},[29],"docs-table-wrap","\n    ",[32,33,34,35,34,52,30],"table",{},"\n      ",[36,37,38,39,34],"thead",{},"\n        ",[40,41,42,46,49],"tr",{},[43,44,45],"th",{},"工具",[43,47,48],{},"用途",[43,50,51],{},"安全模型",[53,54,38,55,38,70,38,83,34],"tbody",{},[40,56,57,64,67],{},[58,59,60],"td",{},[61,62,63],"code",{},"openpets_status",[58,65,66],{},"检查 OpenPets 是否可达及当前目标宠物。",[58,68,69],{},"只读的设置与健康检查。",[40,71,72,77,80],{},[58,73,74],{},[61,75,76],{},"openpets_react",[58,78,79],{},"在不显示文本的情况下更改宠物反应。",[58,81,82],{},"用于静默状态，如思考、测试、等待、成功或错误。",[40,84,85,90,93],{},[58,86,87],{},[61,88,89],{},"openpets_say",[58,91,92],{},"显示一条简短的可见对话气泡。",[58,94,95],{},"拒绝过长、多行、类代码、含 URL/路径或看起来像密钥的消息。",[22,97,98,99,102,103,106],{},"\n    运行时在本地进行。你的 MCP 客户端启动 ",[61,100,101],{},"@open-pets/mcp","，MCP server 使用 ",[61,104,105],{},"@open-pets/client","，客户端通过本地 IPC 与正在运行的 OpenPets 桌面应用通信。\n  ",[11,108,16,111,16,114],{"id":109,"className":110},"requirements",[15],[18,112,113],{"id":113},"使用要求",[115,116,30,117,30,121,30,124,16],"ul",{},[118,119,120],"li",{},"OpenPets 桌面应用必须正在运行，宠物更新才能生效。",[118,122,123],{},"你的助手或编辑器必须支持 stdio MCP server。",[118,125,126,127,130],{},"如果使用已发布的 ",[61,128,129],{},"npx"," 命令，必须有可用的 Node.js 和 npm。",[11,132,16,135,16,139,16,142,16,163],{"id":133,"className":134},"config",[15],[18,136,138],{"id":137},"通用-mcp-配置","通用 MCP 配置",[22,140,141],{},"\n    MCP 客户端使用不同的根键，但命令和参数才是关键。请根据客户端的 MCP 格式调整包装结构。\n  ",[26,143,30,146,30,157,16],{"className":144},[145],"docs-code",[26,147,150,154],{"className":148},[149],"docs-code-bar",[151,152,153],"span",{},"通用 stdio MCP server",[151,155,156],{},"json",[158,159,160],"pre",{},[61,161,162],{},"{\n  \"mcpServers\": {\n    \"openpets\": {\n      \"type\": \"stdio\",\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@open-pets/mcp@latest\"]\n    }\n  }\n}",[22,164,165,166,169,170,173,174,177,178,181,182,184,185,188],{},"\n    某些客户端使用 ",[61,167,168],{},"servers","、",[61,171,172],{},"mcp"," 或 ",[61,175,176],{},"context_servers"," 作为根键，而非 ",[61,179,180],{},"mcpServers","。除非你的客户端需要不同的可执行文件格式，否则命令保持为 ",[61,183,129],{},"，参数保持为 ",[61,186,187],{},"[\"-y\", \"@open-pets/mcp@latest\"]","。\n  ",[11,190,16,193,16,196,16,202,16,218],{"id":191,"className":192},"pet-routing",[15],[18,194,195],{"id":195},"宠物路由",[22,197,198,199,188],{},"\n    默认情况下，MCP server 指向桌面应用的默认宠物。当你希望此 MCP 进程请求特定已安装宠物时，添加 ",[61,200,201],{},"--pet \u003Cpet-id>",[26,203,30,205,30,213,16],{"className":204},[145],[26,206,208,211],{"className":207},[149],[151,209,210],{},"指向特定宠物",[151,212,156],{},[158,214,215],{},[61,216,217],{},"{\n  \"mcpServers\": {\n    \"openpets\": {\n      \"type\": \"stdio\",\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@open-pets/mcp@latest\", \"--pet\", \"fixer\"]\n    }\n  }\n}",[115,219,30,220,30,223,30,226,16],{},[118,221,222],{},"如果请求的宠物可用，OpenPets 会将此 MCP 会话路由到该宠物。",[118,224,225],{},"如果请求的宠物缺失或不可用，OpenPets 会安全回退，而不会中断助手。",[118,227,228],{},"显式宠物路由使用短租约，代理宠物可以自动清理。",[11,230,16,233,16,236,16,239],{"id":231,"className":232},"instructions",[15],[18,234,235],{"id":235},"推荐的助手指令",[22,237,238],{},"\n    MCP 为你的助手提供工具，而指令则教会它如何使用这些工具，同时避免将私有上下文泄露到可见的桌面气泡中。在你的 MCP 客户端存储助手指令的位置添加一个简短的规则块。\n  ",[26,240,30,242,30,251],{"className":241},[145],[26,243,245,248],{"className":244},[149],[151,246,247],{},"OpenPets 助手引导",[151,249,250],{},"md",[158,252,253,256],{},[61,254,255],{},"OpenPets MCP tools may be available.\n",[115,257,258,272],{},[61,259,260,263,266,269],{},[118,261,262],{},"Use openpets_status before using OpenPets or when debugging availability.",[118,264,265],{},"Use openpets_react for silent state changes like thinking, editing, testing, waiting, success, or error.",[118,267,268],{},"Use openpets_say only for short visible status messages.",[118,270,271],{},"Never send code, logs, command output, file paths, URLs, secrets, tokens, user prompts, or private data to openpets_say.",[118,273,274],{},[61,275,276],{},"Do not spam every internal step.",[11,278,16,281,16,284,16,287,16,304],{"id":279,"className":280},"test",[15],[18,282,283],{"id":283},"测试连接",[22,285,286],{},"\n    MCP 客户端加载 server 后，让它主动使用 OpenPets：\n  ",[26,288,30,290,30,299,16],{"className":289},[145],[26,291,293,296],{"className":292},[149],[151,294,295],{},"测试提示词",[151,297,298],{},"text",[158,300,301],{},[61,302,303],{},"Check OpenPets status. If it is available, send a short \"connected\" message and a waving reaction.",[22,305,306,307,169,309,311,312,188],{},"\n    如果你的客户端在调试面板中显示 MCP 工具调用，你应该能看到 ",[61,308,63],{},[61,310,76],{}," 和 ",[61,313,89],{},[11,315,16,318,16,321],{"id":316,"className":317},"safety",[15],[18,319,320],{"id":320},"安全性与行为",[26,322,30,324,16],{"className":323},[29],[32,325,34,326,34,336,30],{},[36,327,328],{},[40,329,330,333],{},[43,331,332],{},"保护机制",[43,334,335],{},"行为说明",[53,337,38,338,38,348,38,356,38,364,34],{},[40,339,340,343],{},[58,341,342],{},"简短语音",[58,344,345,347],{},[61,346,89],{}," 接受最多 140 个字符的消息。",[40,349,350,353],{},[58,351,352],{},"单行限制",[58,354,355],{},"多行消息会被拒绝。",[40,357,358,361],{},[58,359,360],{},"禁止代码或日志",[58,362,363],{},"类代码文本、命令输出、URL、文件路径和看起来像密钥的文本会被拒绝。",[40,365,366,369],{},[58,367,368],{},"尽力可用性",[58,370,371],{},"如果桌面应用已关闭，工具会返回 MCP 错误，而不是导致你的助手崩溃。",[11,373,16,376,16,379,16,384,16,402,16,406,16,424,16,428],{"id":374,"className":375},"troubleshooting",[15],[18,377,378],{"id":378},"故障排查",[380,381,383],"h3",{"id":382},"mcp-工具未出现","MCP 工具未出现",[115,385,30,386,30,389,30,392,30,399,16],{},[118,387,388],{},"更改配置后重启或重新加载你的 MCP 客户端。",[118,390,391],{},"确认客户端支持 stdio MCP server。",[118,393,394,395,398],{},"在终端运行 ",[61,396,397],{},"npx -y @open-pets/mcp@latest --help","，确认 npm 能解析该包。",[118,400,401],{},"检查你的配置是否使用了客户端对应的正确根键。",[380,403,405],{"id":404},"工具出现但-openpets-不可用","工具出现但 OpenPets 不可用",[115,407,30,408,30,411,30,417,16],{},[118,409,410],{},"先打开 OpenPets 桌面应用。",[118,412,413,414,416],{},"让助手调用 ",[61,415,63],{},"。",[118,418,419,420,423],{},"如果使用了 ",[61,421,422],{},"--pet","，请通过 OpenPets 桌面应用或 OpenPets CLI 确认该宠物 ID 已安装。",[380,425,427],{"id":426},"我应该使用通用-mcp-还是专用集成","我应该使用通用 MCP 还是专用集成？",[22,429,430],{},"\n    使用 Claude Code 或 OpenCode 时，请使用对应的专用页面，它们包含专属设置流程和托管指令。当你的工具支持 MCP 但 OpenPets 尚未为其提供专用设置页面时，使用通用 MCP。\n  ",{"title":432,"searchDepth":433,"depth":433,"links":434},"",2,[435,436,437,438,439,440,441,442],{"id":20,"depth":433,"text":20},{"id":113,"depth":433,"text":113},{"id":137,"depth":433,"text":138},{"id":195,"depth":433,"text":195},{"id":235,"depth":433,"text":235},{"id":283,"depth":433,"text":283},{"id":320,"depth":433,"text":320},{"id":378,"depth":433,"text":378,"children":443},[444,446,447],{"id":382,"depth":445,"text":383},3,{"id":404,"depth":445,"text":405},{"id":426,"depth":445,"text":427},"通过已发布的 OpenPets MCP server、安全工具、宠物路由和本地桌面 IPC，将任何支持 stdio MCP 的助手连接到 OpenPets。","stdio MCP","fa6-solid:plug",null,{},"通用 MCP",6,"/zh/integrations/mcp",{"title":5,"description":448},"已支持","zh/integrations/mcp","使用已发布的 @open-pets/mcp server，将任何支持 stdio MCP 的助手连接到 OpenPets。","t20qUlLYIykkz_UPmnDq080_SdQt3bSkkhGKSn0--Uo",1779284856945]