Skip to content
Back to search

agent-workers-mcp

MCP server that lets Claude Code hand work to Gemini (Antigravity CLI) and DeepSeek, with a read-only guard and secret scanner

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/satleixn--agent-workers-mcp/badge.svg)](/listings/satleixn--agent-workers-mcp)

HTML

<a href="/listings/satleixn--agent-workers-mcp"><img src="/api/listings/satleixn--agent-workers-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

git clone https://github.com/Satleixn/agent-workers-mcp.git
cd agent-workers-mcp
python -m venv .venv
.\.venv\Scripts\pip install -r requirements.txt

然后**完全退出 Claude**,运行:

python install.py

> 如果仓库所在的目录带有低完整性标签(某些工具的沙箱会给整个工作目录加上这个标签,用 `icacls` 能看到 `Low Mandatory Level`),从仓库里的 `.venv` 启动的程序读不到 `%LOCALAPPDATA%`,也就找不到 agy。这时把 venv 建在别处,例如 `python -m venv $HOME\.venvs\agent-workers-mcp`,再用 `python install.py --python $HOME\.venvs\agent-workers-mcp\Scripts\python.exe` 注册。

它会备份并修改 `~/.claude.json`(加入 `mcpServers.workers`),把两个子代理复制到 `~/.claude/agents/`。重新打开 Claude 后,新会话里就有 `mcp__workers__*` 三个工具。最后,把 `docs/claude-md-snippet.md` 的内容按需加进你的 `~/.claude/CLAUDE.md`。

先在命令行确认两边都能用(venv 不在仓库里时,把 `.\.venv\Scripts\python` 换成你那个 venv 的 python):

.\.venv\Scripts\python ask_gemini.py --prompt "Reply with exactly: OK" --model gemini-4-hydrogen-low
.\.venv\Scripts\python ask_deepseek.py --prompt "用一句话说明什么是移动平均线"

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 99 lines
  1. # agent-workers-mcp
  2. > An MCP server that lets Claude Code hand work to Gemini (via the Antigravity CLI, on a Google AI subscription) and DeepSeek (pay-per-token API), with a read-only guard, a secret scanner and a local call log.
  3. 让 Claude 当主脑、把一部分工作交给"工人"模型的 MCP 服务:
  4. - **Gemini**:通过 Antigravity CLI(`agy`)调用,只用 Google 订阅额度,**不会自动改走付费 API**。适合读大量文件后做总结、第二意见审查、整个仓库的只读审查。
  5. - **DeepSeek**:直接调 OpenAI 兼容 API,按 token 付费。适合起草、改写、翻译这类批量文字工作。
  6. - Claude 负责拆任务、写任务说明、核验结果;工人的回答只当线索。
  7. ## 组成
  8. | 文件 | 作用 |
  9. |---|---|
  10. | `workers_mcp.py` | MCP 服务(stdio),提供 `ask_gemini`、`ask_deepseek`、`gemini_quota` 三个工具 |
  11. | `ask_gemini.py` | 调用 agy;也可以直接在命令行用 |
  12. | `ask_deepseek.py` | 调用 DeepSeek API;也可以直接在命令行用 |
  13. | `agy_guard.py` | agy 的 `PreToolUse` 钩子:每次调用都强制只读 |
  14. | `worker_common.py` | 共用的密钥检查、大小上限、调用日志 |
  15. | `agents/` | 两个 Claude Code 子代理:`gemini-reviewer`(第二意见审查)、`deepseek-drafter`(起草和翻译) |
  16. | `docs/manual.md` | 操作说明书:用法、模型分档、日志、常见问题 |
  17. | `docs/claude-md-snippet.md` | 建议加进 `~/.claude/CLAUDE.md` 的一节,告诉 Claude 什么时候交给工人 |
  18. | `install.py` | 注册 MCP 服务、安装子代理 |
  19. | `LICENSE` | MIT 许可证 |
  20. ## 安全设计
  21. - **Gemini 只能读**:agy 在新建的临时目录里以 `--mode plan` 运行;每次调用都在临时目录写一份工作区本地钩子(`.agents/hooks.json`),由 `agy_guard.py` 判定 agy 的每一次操作:
  22. - 只放行 `read_file`,而且文件必须在工作区内,并通过下面的密钥检查;
  23. - 执行命令、写文件、访问网页等其他一切操作都拒绝;钩子自己出错也拒绝。
  24. - 这个钩子只对本服务发起的调用生效,不影响你自己平时用 agy。
  25. - **密钥不外发**:按文件名(`secrets.toml`、`.env*`、证书和私钥、云服务凭据……)、目录(`.ssh`、`.aws`……)和内容(`sk-…`、`AIza…`、GitHub/AWS/Slack/Stripe/Hugging Face/npm 令牌、JWT、私钥块、带密码的连接串、硬编码的密钥赋值)拦截。报错只给类型和行号,不显示内容。
  26. - **不会误走付费 API**:传给 agy 的环境变量去掉了所有 Key 和令牌;每次调用都用 `--settings` 关掉付费兜底(`useG1Credits`)和 Gemini API 直连(`modelProvider`),不改你自己的 agy 设置。
  27. - **额度保护**:每次调用前自动查一次额度(缓存 60 秒)。模型所在额度池里任何一项低于 10% 就拒绝;Gemini 5 小时额度低于 25% 时,拒绝 neon-high 和 xhigh。
  28. - **调用日志只在本机**:`logs/YYYY-MM.jsonl` 记下每次真正发出的调用(提示词、文件指纹、回答、用量、钩子的每次判定),保留 3 个月;被安全检查拒绝的请求不记录。`logs/` 不进 git。
  29. ## 要求
  30. - Windows 10/11(安装脚本和进程管理用到了 `tasklist`、`taskkill`、`.venv\Scripts`)
  31. - Python 3.10+
  32. - Google Antigravity CLI(`agy`),已经用有 Gemini 订阅的 Google 账号登录(在终端运行一次 `agy` 按提示登录)
  33. - DeepSeek API Key(只用 Gemini 的话可以不要),设为用户级环境变量 `DEEPSEEK_API_KEY`
  34. - Claude Code(桌面版或 CLI)
  35. ## 安装
  36. ```powershell
  37. git clone https://github.com/Satleixn/agent-workers-mcp.git
  38. ```
  39. ```powershell
  40. cd agent-workers-mcp
  41. ```
  42. ```powershell
  43. python -m venv .venv
  44. ```
  45. ```powershell
  46. .\.venv\Scripts\pip install -r requirements.txt
  47. ```
  48. 然后**完全退出 Claude**,运行:
  49. ```powershell
  50. python install.py
  51. ```
  52. > 如果仓库所在的目录带有低完整性标签(某些工具的沙箱会给整个工作目录加上这个标签,用 `icacls` 能看到 `Low Mandatory Level`),从仓库里的 `.venv` 启动的程序读不到 `%LOCALAPPDATA%`,也就找不到 agy。这时把 venv 建在别处,例如 `python -m venv $HOME\.venvs\agent-workers-mcp`,再用 `python install.py --python $HOME\.venvs\agent-workers-mcp\Scripts\python.exe` 注册。
  53. 它会备份并修改 `~/.claude.json`(加入 `mcpServers.workers`),把两个子代理复制到 `~/.claude/agents/`。重新打开 Claude 后,新会话里就有 `mcp__workers__*` 三个工具。最后,把 `docs/claude-md-snippet.md` 的内容按需加进你的 `~/.claude/CLAUDE.md`。
  54. 先在命令行确认两边都能用(venv 不在仓库里时,把 `.\.venv\Scripts\python` 换成你那个 venv 的 python):
  55. ```powershell
  56. .\.venv\Scripts\python ask_gemini.py --prompt "Reply with exactly: OK" --model gemini-4-hydrogen-low
  57. ```
  58. ```powershell
  59. .\.venv\Scripts\python ask_deepseek.py --prompt "用一句话说明什么是移动平均线"
  60. ```
  61. ## 用法
  62. 平时直接对 Claude 说,例如:
  63. - "让 Gemini 以读仓库模式审查 `D:\path\to\repo`,重点看错误处理"
  64. - "让 gemini-reviewer 审查 `src/foo.py` 里的 `bar()`"
  65. - "用 ask_deepseek 把这段翻成英文"
  66. - "查一下 Gemini 额度"
  67. 模型怎么选、日志怎么查、常见报错怎么处理,见 [docs/manual.md](docs/manual.md)。
  68. ## 已知限制
  69. - 只在 Windows 上测试过。
  70. - Gemini 和 DeepSeek 的模型名会变,默认模型写在 `ask_gemini.py`、`ask_deepseek.py` 顶部的 `DEFAULT_MODEL`,分档表在 `workers_mcp.py` 的工具描述里。
  71. - 读仓库模式下 agy 不能执行命令,所以不能全文搜索;它按 `FILES.txt`(`git ls-files` 的结果)挑文件读。
  72. - 每次 Gemini 调用固定有约 2.5 万 token 的代理开销,小问题要合并成一次问。
  73. ## 许可证
  74. [MIT](LICENSE)。本项目只是调用 Antigravity CLI 和 DeepSeek API 的工具,使用时仍须遵守 Google 和 DeepSeek 各自的服务条款。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.