[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6GK4CMGT0JQ6SC4KVSCW3Z9":3,"skill-same:01M6GK4CMGT0JQ6SC4KVSCW3Z9":73},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":22,"publishedAt":41,"linkOnly":42,"markdownContent":43,"markdownBody":44,"frontMatter":45,"refName":53,"commitSha":54,"skillDirectory":55,"forksCount":13,"repositoryHtmlUrl":56,"repositoryHomepageUrl":6,"ownerHtmlUrl":57,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":58,"install":59,"resources":72},"01M6GK4CMGT0JQ6SC4KVSCW3Z9","MCP协议",null,"当你需要在 super-agent-v3 中实现或维护 cmd\u002Fmcp-* sidecar、MCP tools\u002Fresources、stdio MCP、legacy HTTP MCP 或 provider MCP 配置时使用。","lihah111222333-cloud\u002FSuper-Dolphin-Agent-Cockpit","lihah111222333-cloud","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F254297992?v=4","01M6GJZ7ZK31PVRBS5XQWS56ET","01M6GJZ84Q0ANFYMPVK56PYSNW",0,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Flihah111222333-cloud\u002FSuper-Dolphin-Agent-Cockpit\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002FMCP协议\u002FSKILL.md",[17],{"categoryNo":18,"categoryName":19,"taxonomyType":20,"taxonomyTypeDesc":21},"01JBSEEDCAT000000000000023","Skill与智能体开发","SCENARIO","使用场景",[5,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40],"model","resources","v3","patterns","provider","Legacy","context","prompt","cmd","MCP","tool","Tools","server","mcp tools","protocol","http","model context protocol","mcp server","2026-11-10 10:12:30",false,"---\nname: \"MCP协议\"\ndisplay_name: \"MCP协议\"\ndescription: \"当你需要在 super-agent-v3 中实现或维护 cmd\u002Fmcp-* sidecar、MCP tools\u002Fresources、stdio MCP、legacy HTTP MCP 或 provider MCP 配置时使用。\"\ntrigger_words: [\"mcp-server-patterns\", \"MCP\", \"Model Context Protocol\", \"mcp server\", \"stdio MCP\", \"legacy HTTP\", \"tool\", \"resource\", \"prompt\", \"协议\"]\n---\n\n# MCP 协议与服务模式\n\n## 仓库事实\n\nsuper-agent-v3 的 MCP 实现以源码和契约为准：\n\n- sidecar 入口：`cmd\u002Fmcp-orch`、`cmd\u002Fmcp-lsp`、`cmd\u002Fmcp-ida`。\n- 通用协议层：`internal\u002Fmcpserver\u002Fcommon`，包括 stdio transport、JSON-RPC server、tool provider、legacy HTTP transport。\n- 当前工具执行主路径是 **stdio MCP**；`legacy HTTP` 仅保留给旧调用方或 peer mode 包装，不应作为新功能默认路径。\n- mcp-orch 负责编排、DAG、workspace、prompt、command card、shared file 等工具出口；DAG 工具必须遵守 `task_create_dag` \u002F `task_dag_apply_ops` \u002F `task_update_node` 的状态与版本约束。\n- mcp-lsp 是 generic multi-language LSP peer，不要把它写成单语言服务。\n\n## 何时使用\n\n- 新增或修改 `cmd\u002Fmcp-*` 工具、schema、handler、manifest、bootstrap 或 transport。\n- 排查 stdio MCP framing、stdout 污染、Content-Length、JSON-RPC 错误码、tool payload envelope。\n- 修改 provider 侧 MCP server config、turn manifest、stdio command allowlist、HTTP\u002Fstdio 配置合并。\n- 审查 mcp-orch DAG\u002Fwakeup\u002Flease 工具是否正确写入状态。\n\n## 快速参考\n\n| 场景 | 正确入口 |\n|---|---|\n| 新增 mcp-orch 工具 | `cmd\u002Fmcp-orch\u002Ftools` + registry\u002Fprovider 映射 + 同包测试 |\n| 新增 mcp-lsp 工具 | `cmd\u002Fmcp-lsp\u002Ftools` + `cmd\u002Fmcp-lsp\u002Ftools.go` 注册 + LSP\u002Fhandler 测试 |\n| 协议层变更 | `internal\u002Fmcpserver\u002Fcommon`，同时验证 stdio 与 legacy HTTP 行为是否保持兼容 |\n| provider MCP 配置 | `internal\u002Fprovider\u002Fshared\u002Fconfig_helpers.go`、`internal\u002Fmodule\u002Fturn\u002F*manifest*` |\n| DAG 生命周期 | `cmd\u002Fmcp-orch\u002Forchestration`、`cmd\u002Fmcp-orch\u002Fstore\u002Ftaskdag`、`cmd\u002Fmcp-orch\u002Fsql\u002Fqueries\u002Ftask_dag*` |\n\n## 实现规则\n\n1. stdout 属于 MCP stdio 帧；普通日志、panic、fmt 调试输出必须走 stderr 或日志文件。\n2. 工具参数必须 schema-first、强校验、fail-fast；不要用 `map[string]any` 静默吞字段。\n3. stdio 和 legacy HTTP 共享语义时，错误 envelope、payload 日志和 scope 不能分叉。\n4. provider 配置只接受 `stdio` 或 `http` transport；未知 transport 必须报错。\n5. 修改 DAG 工具时必须处理版本冲突、running\u002Factive run 下的节点结构变更限制，以及 done\u002Ffailed 状态的下游影响。\n6. server identity、transport、provider 和必需依赖为空时必须在构造或启动边界报错；不得用 `mcp-server`、`dev` 或空实现补成可运行状态，并补失败测试。\n\n## 验证\n\n- Go 文件变更后先跑单文件守卫：`.\u002Fscripts\u002Ftest_with_guard.sh \u003Cfile.go>`。\n- MCP sidecar\u002Ftool contract 改动至少跑受影响包：`.\u002Fscripts\u002Ftest_with_guard.sh .\u002Fcmd\u002Fmcp-orch .\u002Finternal\u002Fmcpserver\u002Fcommon -count=1`，按实际改动替换包列表。\n- provider\u002Fturn manifest 改动跑对应 provider\u002Fmodule 包测试。\n- 如果改了 SQL\u002Fstore，追加 `make sqlc-verify`。\n\n## 常见错误\n\n| 错误 | 修正 |\n|---|---|\n| 把 HTTP transport 当新工具默认路径 | 新工具默认 stdio MCP；legacy HTTP 只保持兼容 |\n| stdout 打印日志 | 改为 stderr\u002Flog，避免破坏 MCP 帧 |\n| tool handler 接受任意 map 后默认空值 | 明确 schema 和字段校验，缺字段立即报错 |\n| 手写“已排程”但只改 metadata | scheduled DAG 必须通过 `task_dag_apply_ops(update_dag)` 写 trigger\u002Fcron |\n| 在 running DAG 上 add\u002Fupdate\u002Fremove node | 结构变更应 fail-fast；只允许受支持的 future metadata 更新 |\n","# MCP 协议与服务模式\n\n## 仓库事实\n\nsuper-agent-v3 的 MCP 实现以源码和契约为准：\n\n- sidecar 入口：`cmd\u002Fmcp-orch`、`cmd\u002Fmcp-lsp`、`cmd\u002Fmcp-ida`。\n- 通用协议层：`internal\u002Fmcpserver\u002Fcommon`，包括 stdio transport、JSON-RPC server、tool provider、legacy HTTP transport。\n- 当前工具执行主路径是 **stdio MCP**；`legacy HTTP` 仅保留给旧调用方或 peer mode 包装，不应作为新功能默认路径。\n- mcp-orch 负责编排、DAG、workspace、prompt、command card、shared file 等工具出口；DAG 工具必须遵守 `task_create_dag` \u002F `task_dag_apply_ops` \u002F `task_update_node` 的状态与版本约束。\n- mcp-lsp 是 generic multi-language LSP peer，不要把它写成单语言服务。\n\n## 何时使用\n\n- 新增或修改 `cmd\u002Fmcp-*` 工具、schema、handler、manifest、bootstrap 或 transport。\n- 排查 stdio MCP framing、stdout 污染、Content-Length、JSON-RPC 错误码、tool payload envelope。\n- 修改 provider 侧 MCP server config、turn manifest、stdio command allowlist、HTTP\u002Fstdio 配置合并。\n- 审查 mcp-orch DAG\u002Fwakeup\u002Flease 工具是否正确写入状态。\n\n## 快速参考\n\n| 场景 | 正确入口 |\n|---|---|\n| 新增 mcp-orch 工具 | `cmd\u002Fmcp-orch\u002Ftools` + registry\u002Fprovider 映射 + 同包测试 |\n| 新增 mcp-lsp 工具 | `cmd\u002Fmcp-lsp\u002Ftools` + `cmd\u002Fmcp-lsp\u002Ftools.go` 注册 + LSP\u002Fhandler 测试 |\n| 协议层变更 | `internal\u002Fmcpserver\u002Fcommon`，同时验证 stdio 与 legacy HTTP 行为是否保持兼容 |\n| provider MCP 配置 | `internal\u002Fprovider\u002Fshared\u002Fconfig_helpers.go`、`internal\u002Fmodule\u002Fturn\u002F*manifest*` |\n| DAG 生命周期 | `cmd\u002Fmcp-orch\u002Forchestration`、`cmd\u002Fmcp-orch\u002Fstore\u002Ftaskdag`、`cmd\u002Fmcp-orch\u002Fsql\u002Fqueries\u002Ftask_dag*` |\n\n## 实现规则\n\n1. stdout 属于 MCP stdio 帧；普通日志、panic、fmt 调试输出必须走 stderr 或日志文件。\n2. 工具参数必须 schema-first、强校验、fail-fast；不要用 `map[string]any` 静默吞字段。\n3. stdio 和 legacy HTTP 共享语义时，错误 envelope、payload 日志和 scope 不能分叉。\n4. provider 配置只接受 `stdio` 或 `http` transport；未知 transport 必须报错。\n5. 修改 DAG 工具时必须处理版本冲突、running\u002Factive run 下的节点结构变更限制，以及 done\u002Ffailed 状态的下游影响。\n6. server identity、transport、provider 和必需依赖为空时必须在构造或启动边界报错；不得用 `mcp-server`、`dev` 或空实现补成可运行状态，并补失败测试。\n\n## 验证\n\n- Go 文件变更后先跑单文件守卫：`.\u002Fscripts\u002Ftest_with_guard.sh \u003Cfile.go>`。\n- MCP sidecar\u002Ftool contract 改动至少跑受影响包：`.\u002Fscripts\u002Ftest_with_guard.sh .\u002Fcmd\u002Fmcp-orch .\u002Finternal\u002Fmcpserver\u002Fcommon -count=1`，按实际改动替换包列表。\n- provider\u002Fturn manifest 改动跑对应 provider\u002Fmodule 包测试。\n- 如果改了 SQL\u002Fstore，追加 `make sqlc-verify`。\n\n## 常见错误\n\n| 错误 | 修正 |\n|---|---|\n| 把 HTTP transport 当新工具默认路径 | 新工具默认 stdio MCP；legacy HTTP 只保持兼容 |\n| stdout 打印日志 | 改为 stderr\u002Flog，避免破坏 MCP 帧 |\n| tool handler 接受任意 map 后默认空值 | 明确 schema 和字段校验，缺字段立即报错 |\n| 手写“已排程”但只改 metadata | scheduled DAG 必须通过 `task_dag_apply_ops(update_dag)` 写 trigger\u002Fcron |\n| 在 running DAG 上 add\u002Fupdate\u002Fremove node | 结构变更应 fail-fast；只允许受支持的 future metadata 更新 |\n",{"name":5,"description":7,"display_name":5,"trigger_words":46},[47,32,48,40,49,50,33,51,30,52],"mcp-server-patterns","Model Context Protocol","stdio MCP","legacy HTTP","resource","协议","main","287849f4ce06aaaa7e8f517126f73b016043d332",".agents\u002Fskills\u002FMCP协议","https:\u002F\u002Fgithub.com\u002Flihah111222333-cloud\u002FSuper-Dolphin-Agent-Cockpit","https:\u002F\u002Fgithub.com\u002Flihah111222333-cloud","2026-10-11 02:13:17",{"source":8,"skillName":5,"commands":60,"prompt":70,"zipAvailable":71},[61,64,67],{"tool":62,"command":63},"npx","npx skills add lihah111222333-cloud\u002FSuper-Dolphin-Agent-Cockpit --skill \"MCP协议\"",{"tool":65,"command":66},"bunx","bunx skills add lihah111222333-cloud\u002FSuper-Dolphin-Agent-Cockpit --skill \"MCP协议\"",{"tool":68,"command":69},"pnpm","pnpm dlx skills add lihah111222333-cloud\u002FSuper-Dolphin-Agent-Cockpit --skill \"MCP协议\"","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Flihah111222333-cloud\u002FSuper-Dolphin-Agent-Cockpit\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002FMCP协议\u002FSKILL.md",true,[],[74,98,113,136,151,165],{"skillNo":75,"name":76,"nameZh":6,"description":77,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":78,"categories":79,"keywords":81,"publishedAt":41},"01M6GK59PDCBRZQ6D03BGXM8XM","mcp-lsp-project-config","配置、安装、检查、修复或迁移项目级 mcp-lsp stdio MCP，覆盖 Codex、Claude Code 和 Google Antigravity，以及 Windows 原生、WSL 原生和 Windows 宿主通过 wsl.exe 桥接 Linux sidecar 的自动选型。用户提到项目 MCP、LSP MCP、.codex\u002Fconfig.toml、.mcp.json、.agents\u002Fmcp_config.json、Codex 中 LSP 工具有时直接暴露有时只在延迟工具目录、ALL_TOOLS 过滤为空、工具已显示但调用报 client is closing、EOF、Transport closed，或希望三个客户端共用仓库内 mcp-lsp 时使用。","https:\u002F\u002Fgithub.com\u002Flihah111222333-cloud\u002FSuper-Dolphin-Agent-Cockpit\u002Fblob\u002Fmain\u002Fbin\u002FLSP\u002Fmcp-lsp-project-config-skill\u002FSKILL.md",[80],{"categoryNo":18,"categoryName":19,"taxonomyType":20,"taxonomyTypeDesc":21},[82,32,83,84,85,86,87,88,89,90,91,92,34,93,94,95,96,97],"mcp lsp project config","config","lsp","project","mcp lsp","google","linux","antigravity","codex","windows","code","json","toml","client","工具","closing",{"skillNo":99,"name":100,"nameZh":6,"description":101,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":102,"categories":103,"keywords":104,"publishedAt":41},"01M6GK57H2A7XK3QZ00HCV9XM0","注释规范","当在 super-agent-v3 中编写或审查 Go 函数级中文注释、React hooks\u002Fservice\u002Fcontroller 注释，或处理注释守卫失败时使用。","https:\u002F\u002Fgithub.com\u002Flihah111222333-cloud\u002FSuper-Dolphin-Agent-Cockpit\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002F注释规范\u002FSKILL.md",[],[100,105,106,107,108,109,110,25,111,112],"go","react","controller","中文","hooks","service","react hooks","comments",{"skillNo":114,"name":115,"nameZh":6,"description":116,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":117,"categories":118,"keywords":122,"publishedAt":41},"01M6GK545MTTE5X1Q4NF92PNRN","字段守卫","当新增、删除、重命名或跨层传递结构化字段，以及修改 DTO、mapper、schema、API\u002FRPC、事件、配置、store、序列化或前后端契约时自动使用；追踪生产源到全部消费端并建立 fail-fast 字段守卫。","https:\u002F\u002Fgithub.com\u002Flihah111222333-cloud\u002FSuper-Dolphin-Agent-Cockpit\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002F字段守卫\u002FSKILL.md",[119],{"categoryNo":120,"categoryName":121,"taxonomyType":20,"taxonomyTypeDesc":21},"01JBSEEDCAT000000000000010","后端与接口",[115,123,124,125,126,127,83,128,129,130,131,132,133,134,135],"后端","event","payload","store","mapping","rpc","fast","api","guard","消费","schema","drift","contract",{"skillNo":137,"name":123,"nameZh":6,"description":138,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":139,"categories":140,"keywords":143,"publishedAt":41},"01M6GK50VVC89B3MMSTKBG76ZS","在 super-agent-v3 中编写、审查或重构 Go 后端代码时使用。","https:\u002F\u002Fgithub.com\u002Flihah111222333-cloud\u002FSuper-Dolphin-Agent-Cockpit\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002F后端\u002FSKILL.md",[141,142],{"categoryNo":120,"categoryName":121,"taxonomyType":20,"taxonomyTypeDesc":21},{"categoryNo":18,"categoryName":19,"taxonomyType":20,"taxonomyTypeDesc":21},[123,144,145,31,146,105,32,147,148,149,25,150,126],"sqlc","backend","golang","runner","platform","module","fx",{"skillNo":152,"name":153,"nameZh":6,"description":154,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":155,"categories":156,"keywords":160,"publishedAt":41},"01M6GK4YP5DTSBD02AF8YSRNME","前端","当在 super-agent-v3 中开发、审查或修复当前 React\u002FVite 前端 UI 时使用；前端源码只在 frontend-app。","https:\u002F\u002Fgithub.com\u002Flihah111222333-cloud\u002FSuper-Dolphin-Agent-Cockpit\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002F前端\u002FSKILL.md",[157],{"categoryNo":158,"categoryName":159,"taxonomyType":20,"taxonomyTypeDesc":21},"01JBSEEDCAT000000000000009","前端开发",[161,162,163,25,164,106],"frontend","vite","app","ui",{"skillNo":166,"name":167,"nameZh":6,"description":168,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":169,"categories":170,"keywords":171,"publishedAt":41},"01M6GK4WWB9A6N51VPCZHC3NB1","全量项目地图生成","当在 super-agent-v3 中生成、更新或校验 docs\u002Fdoc\u002Fcodemap 项目地图、AI index 或能力清单时使用。","https:\u002F\u002Fgithub.com\u002Flihah111222333-cloud\u002FSuper-Dolphin-Agent-Cockpit\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002F全量项目地图生成\u002FSKILL.md",[],[167,172,173,25,174,175,176,177,178],"地图","生成","codemap","校验","doc","index","docs"]