{"_id":"j-agy-mcp","_rev":"3-c0cbe62698c936200f6856ffa43fc941","name":"j-agy-mcp","dist-tags":{"latest":"1.1.1"},"versions":{"1.0.0":{"name":"j-agy-mcp","version":"1.0.0","keywords":["mcp","model-context-protocol","antigravity","agy","gemini","subagent","claude-code","codex"],"license":"MIT","_id":"j-agy-mcp@1.0.0","maintainers":[{"name":"jirachi","email":"jinyonghui1994@gmail.com"}],"homepage":"https://github.com/PichurChill/j-ai-kit/tree/main/packages/j-agy-mcp#readme","bugs":{"url":"https://github.com/PichurChill/j-ai-kit/issues"},"bin":{"j-agy-mcp":"dist/index.js"},"dist":{"shasum":"e551d0c117a5496d18b18ba04603d11e9c074762","tarball":"https://registry.npmjs.org/j-agy-mcp/-/j-agy-mcp-1.0.0.tgz","fileCount":14,"integrity":"sha512-aTcKoKiksj403QTKs1BRtuvoSMUD+Oiae/0ZumHEpYwMpv70LwVqUCsyWab/4bxOjtl2rc+bywHA5LmYsEtPqg==","signatures":[{"sig":"MEQCIE2KQOWARZBMxFnzLDDSr82ZuS1zvqpl/Us/beXC0vYrAiAq6ILGqQtQh9EbzUwfJUT8lOxuYN6nIvkMw9PNtAYLLA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":41064},"main":"dist/index.js","type":"module","engines":{"node":">=20"},"gitHead":"3b60ec80dfcda5cb84c5c63876d8a6434bcf8b48","scripts":{"dev":"tsc --watch","test":"npm run typecheck && npm run build && vitest run","build":"tsc","typecheck":"tsc --noEmit -p tsconfig.test.json","prepublishOnly":"npm run build && npm run typecheck"},"_npmUser":{"name":"jirachi","email":"jinyonghui1994@gmail.com"},"repository":{"url":"git+https://github.com/PichurChill/j-ai-kit.git","type":"git","directory":"packages/j-agy-mcp"},"_npmVersion":"10.9.8","description":"MCP server that wraps the Antigravity CLI (agy) as tools — lets CodeX / Claude Code dispatch exploration or coding tasks to AGY as an external subagent.","directories":{},"_nodeVersion":"22.22.3","dependencies":{"zod":"^4.5.0","@modelcontextprotocol/server":"^2.0.0"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^4.1.0","typescript":"^5.7.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/j-agy-mcp_1.0.0_1788249229096_0.08186091164828846","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"j-agy-mcp","version":"1.0.1","keywords":["mcp","model-context-protocol","antigravity","agy","gemini","subagent","claude-code","codex"],"license":"MIT","_id":"j-agy-mcp@1.0.1","maintainers":[{"name":"jirachi","email":"jinyonghui1994@gmail.com"}],"homepage":"https://github.com/PichurChill/j-ai-kit/tree/main/packages/j-agy-mcp#readme","bugs":{"url":"https://github.com/PichurChill/j-ai-kit/issues"},"bin":{"j-agy-mcp":"dist/index.js"},"dist":{"shasum":"5a79cb01e9d8f1d73f44614261148ce4bf0c9ccc","tarball":"https://registry.npmjs.org/j-agy-mcp/-/j-agy-mcp-1.0.1.tgz","fileCount":17,"integrity":"sha512-KkUjQWua4YZ6oCUvloNi+kipb6rgqYOp8sLaqxAGhtqUOe7pMGd1lHFJwQj1TdhtqjFVjf48BhDhna0x73d24A==","signatures":[{"sig":"MEUCIQCFUxGzyzPFPldZdOFPwWb9voDSMSuvdMrZM2DfVRHL+AIgEOmFaPfVsBPz3ab+yyk93L6nCbBIOGtC4zX2a3l8P/U=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":51303},"main":"dist/index.js","type":"module","engines":{"node":">=20"},"gitHead":"d4d564e2f61faa3a4d7c490318c3ac32a8848406","scripts":{"dev":"tsc --watch","test":"npm run typecheck && npm run build && vitest run","build":"tsc","typecheck":"tsc --noEmit -p tsconfig.test.json","prepublishOnly":"npm run build && npm run typecheck"},"_npmUser":{"name":"jirachi","email":"jinyonghui1994@gmail.com"},"repository":{"url":"git+https://github.com/PichurChill/j-ai-kit.git","type":"git","directory":"packages/j-agy-mcp"},"_npmVersion":"10.9.8","description":"MCP server that wraps the Antigravity CLI (agy) as tools — lets CodeX / Claude Code dispatch exploration or coding tasks to AGY as an external subagent.","directories":{},"_nodeVersion":"22.22.3","dependencies":{"zod":"^4.5.0","@modelcontextprotocol/server":"^2.0.0"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^4.1.0","typescript":"^5.7.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/j-agy-mcp_1.0.1_1788255142722_0.5638693068079597","host":"s3://npm-registry-packages-npm-production"}},"1.1.1":{"name":"j-agy-mcp","version":"1.1.1","description":"MCP server that wraps the Antigravity CLI (agy) as tools — lets CodeX / Claude Code dispatch exploration or coding tasks to AGY as an external subagent.","license":"MIT","repository":{"type":"git","url":"git+https://github.com/PichurChill/j-ai-kit.git","directory":"packages/j-agy-mcp"},"homepage":"https://github.com/PichurChill/j-ai-kit/tree/main/packages/j-agy-mcp#readme","bugs":{"url":"https://github.com/PichurChill/j-ai-kit/issues"},"type":"module","main":"dist/index.js","bin":{"j-agy-mcp":"dist/index.js"},"engines":{"node":">=20"},"scripts":{"build":"tsc","dev":"tsc --watch","typecheck":"tsc --noEmit -p tsconfig.test.json","test":"npm run typecheck && npm run build && vitest run","prepublishOnly":"npm run build && npm run typecheck"},"keywords":["mcp","model-context-protocol","antigravity","agy","gemini","subagent","claude-code","codex"],"dependencies":{"@modelcontextprotocol/server":"^2.0.0","zod":"^4.5.0"},"devDependencies":{"@types/node":"^22.0.0","typescript":"^5.7.0","vitest":"^4.1.0"},"_id":"j-agy-mcp@1.1.1","gitHead":"470fc1eef48fcc9a2a3870a83db7d83717dc20e1","_nodeVersion":"22.22.3","_npmVersion":"10.9.8","dist":{"integrity":"sha512-uOB500LgKQfzhk4dzWjb7G5mZWSneYP+WmK1pK68IJvB5rSvpDX1Be42RcNaK0LkFJnUTntTe6lu6Dm3ZVxtvQ==","shasum":"37f5a3558096e7adbf682c10e030f1484ed0c484","tarball":"https://registry.npmjs.org/j-agy-mcp/-/j-agy-mcp-1.1.1.tgz","fileCount":18,"unpackedSize":60335,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQC73qgzf1fjdwWznKFOD0T/7p+RS+t2xalsw9y7XRGF+AIgbUvxYbf9hD9+XNAlH70MFIYHatYK/dWwic6FRUhvdD8="}]},"_npmUser":{"name":"jirachi","email":"jinyonghui1994@gmail.com"},"directories":{},"maintainers":[{"name":"jirachi","email":"jinyonghui1994@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/j-agy-mcp_1.1.1_1788269277423_0.637880199120854"},"_hasShrinkwrap":false}},"time":{"created":"2026-09-01T07:53:49.038Z","modified":"2026-09-01T13:27:57.742Z","1.0.0":"2026-09-01T07:53:49.250Z","1.0.1":"2026-09-01T09:32:22.867Z","1.1.1":"2026-09-01T13:27:57.577Z"},"bugs":{"url":"https://github.com/PichurChill/j-ai-kit/issues"},"license":"MIT","homepage":"https://github.com/PichurChill/j-ai-kit/tree/main/packages/j-agy-mcp#readme","keywords":["mcp","model-context-protocol","antigravity","agy","gemini","subagent","claude-code","codex"],"repository":{"type":"git","url":"git+https://github.com/PichurChill/j-ai-kit.git","directory":"packages/j-agy-mcp"},"description":"MCP server that wraps the Antigravity CLI (agy) as tools — lets CodeX / Claude Code dispatch exploration or coding tasks to AGY as an external subagent.","maintainers":[{"name":"jirachi","email":"jinyonghui1994@gmail.com"}],"readme":"# j-agy-mcp\n\n[English](./README.md) | 中文\n\n把 **Antigravity CLI(`agy`)** 包装为 MCP 工具的 server,供 **CodeX / Claude Code** 等主代理通过 MCP 协议将探索、检索或编码任务派发给 AGY 作为外部子代理执行。\n\n本 server 不注入任何行为规范——AGY 扮演什么角色(只读探子 / 执行者)完全由调用方的 prompt 与项目规范(如 AGENTS.md)决定。\n\n## 提供的工具\n\n| 工具 | 作用 |\n|:---|:---|\n| `agy_prompt` | 派发一个自包含任务并等待最终结果。AGY 上下文与主代理独立,任务描述需写明目标、目录与验收方式。返回 `conversation_id` 供续聊 |\n| `agy_conversation` | 在已有对话上继续追问或迭代,执行参数与 `agy_prompt` 一致(不会丢失工作目录、模式、模型控制) |\n| `agy_status` | 轮询 `background: true` 启动的后台任务:running(附增量输出尾部)/ done(完整结果)/ error(错误详情) |\n| `agy_models` | 查询当前环境可用的模型列表 |\n\n`agy_prompt` / `agy_conversation` 公共参数:\n\n| 参数 | 默认值 | 说明 |\n|:---|:---|:---|\n| `cwd` | server 启动目录 | 任务工作目录(绝对路径) |\n| `add_dirs` | - | 额外加入工作区的目录 |\n| `mode` | `accept-edits` | `accept-edits`(自动应用修改)或 `plan`(仅规划) |\n| `model` | `Gemini 3.7 Flash (High)` | 模型名,可用 `agy_models` 查询 |\n| `effort` | `high` | 推理强度;模型名已含强度后缀时忽略 |\n| `skip_permissions` | `true` | 自动批准所有权限请求 |\n| `sandbox` | `true` | 启用终端沙箱 |\n| `background` | `false` | 立即返回 `task_id` 并用 `agy_status` 轮询——客户端有硬超时(如 ZCode 30s 掐断工具调用,而真实任务需数分钟)时必传 |\n| `timeout_seconds` | `300` | 超时秒数(1–3600) |\n\n## 特性\n\n- **并发安全**:每次调用独立日志 `<系统临时目录>/j-agy-mcp/<executionId>.log`,互不覆盖;`latest.log` 软链始终指向最近一次,可 `tail -f` 追踪;并发时 stderr 流式输出带 `[agy:xxxxxx]` 短 ID 前缀\n- **结果携带出处**:工具结果元数据包含 `conversation_id`、耗时、turns、tokens 与本次日志路径\n- **进度通知**:客户端提供 `progressToken` 时按 MCP `notifications/progress` 推送增量\n- **超时兜底**:进程级超时先 SIGTERM、2 秒后升级 SIGKILL;并给 CLI 传 `--print-timeout`(超时 +30s)保证结果不会被 CLI 先行放弃\n- **错误可归因**:非零退出、超时、启动失败均携带 stderr 尾部;agy 输出的无法解析行写 stderr 留痕\n- **日志清扫**:启动时自动清理超过 7 天的旧日志\n\n## 使用预设:让 j-agy 干不同的活\n\nj-agy 本身不带角色——AGY 干什么,由派发时的任务描述与你的项目规范(如 AGENTS.md)决定。三种常见用法,各提供两种接法,**同一场景二选一,不要同时配置**(双规则会让行为不一致):\n\n**AGENTS.md 路线** —— 把规则片段贴进你的 AGENTS.md,主代理亲自调 `agy_prompt` 派发:\n\n- [搜索后端](https://github.com/PichurChill/j-ai-kit/tree/main/packages/j-agy-mcp/docs/preset-search.md) — 自带搜索额度用完、故障、结果不满意或主动要求时,当第二搜索出口(不强制,内置优先)\n- [识图后端](https://github.com/PichurChill/j-ai-kit/tree/main/packages/j-agy-mcp/docs/preset-vision.md) — 主模型无多模态、识图故障或失败时的替补(有眼睛先用眼睛)\n- [编码子代理](https://github.com/PichurChill/j-ai-kit/tree/main/packages/j-agy-mcp/docs/preset-coding.md) — 内置子代理不可用、需要保护主上下文或主动要求时外包实现(默认自己写)\n\n**子代理路线** —— 把现成定义复制到 `~/.zcode/agents/`(ZCode,重启生效),主代理按 description 自动派发,执行过程在子代理独立上下文中:\n\n- [搜索子代理](./docs/agents/search-agent.md) · [识图子代理](./docs/agents/vision-agent.md) · [编码子代理](./docs/agents/coder-agent.md)\n\n## 安装与配置\n\n依赖:本机已安装 Antigravity CLI(`agy`)并完成登录。\n\n```json\n{\n  \"mcpServers\": {\n    \"j-agy-mcp\": {\n      \"command\": \"npx\",\n      \"args\": [\"j-agy-mcp\"]\n    }\n  }\n}\n```\n\nCodeX(`~/.codex/config.toml`):\n\n```toml\n[mcp_servers.j-agy-mcp]\ncommand = \"npx\"\nargs = [\"j-agy-mcp\"]\n```\n\n### 环境变量\n\n| 变量 | 说明 |\n|:---|:---|\n| `AGY_BIN` | agy 可执行文件完整路径。MCP server 由 GUI 客户端启动时 PATH 常缺少 `~/.local/bin`,此时必须显式指定,例如 `/Users/you/.local/bin/agy` |\n\n### 本地开发\n\n```bash\nnpm install\nnpm test        # typecheck + build + vitest(fake agy 覆盖执行器与协议层)\nnpm run build\nnode dist/index.js\n```\n\n## 安全说明\n\n默认开启 `--dangerously-skip-permissions`(自动批准)+ `--sandbox`(沙箱),与常见「全自动子代理」用法一致;若要收紧,调用时传 `skip_permissions: false` 或 `sandbox: false`,或用 `mode: \"plan\"` 限制为只规划。未做服务级禁用开关,保持工具面最小。\n\n## 与 @itoseo/agy-mcp 的差异\n\nj-agy-mcp 参考了 [@itoseo/agy-mcp](https://www.npmjs.com/package/@itoseo/agy-mcp) 的行为契约,独立实现(MIT 许可),主要修复:\n\n1. `agy_conversation` 补齐 `cwd` / `mode` / `model` / `effort` / `add_dirs` 等执行参数(原实现续聊时回落到 server 启动目录)\n2. 超时 SIGTERM 2 秒后升级 SIGKILL,错误信息携带 stderr 尾部(原实现进程可能残留且超时无法排障)\n3. 结果渲染防御式读取,agy 返回结构变化时降级显示而非 TypeError\n4. `skip_permissions` / `sandbox` 可按调用关闭;日志目录按系统临时目录解析(跨平台)\n5. `mode` 默认值显式传递,与文档一致\n6. stderr 进入日志;无法解析的输出行可见;progress 不再携带无意义的 `total: 0`\n\n## License\n\nMIT\n","readmeFilename":"README.zh-CN.md"}