English Français العربية

Universal Brute Workpack

السجل الرسمي البحث والويب

Stdio-first Agent MCP workpack for local tools, audit chains, search, memory, and pipelines.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package universal-brute-workpack
Claude Code 
claude mcp add universal-brute-workpack -e 'UBW_CONFIG=<UBW_CONFIG>' -e 'UBW_PROFILES=<UBW_PROFILES>' -e 'UBW_ROOTS=<UBW_ROOTS>' -e 'TAVILY_API_KEY=<your tavily_api_key>' -e 'EXA_API_KEY=<your exa_api_key>' -e 'UBW_MEMORY_URL=<UBW_MEMORY_URL>' -e 'LLM_BASE_URL=<LLM_BASE_URL>' -e 'LLM_API_KEY=<your llm_api_key>' -e 'LLM_MODEL=<LLM_MODEL>' -- npx -y universal-brute-workpack@0.1.4
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "universal-brute-workpack": {
            "command": "npx",
            "args": [
                "-y",
                "universal-brute-workpack@0.1.4"
            ],
            "env": {
                "UBW_CONFIG": "<UBW_CONFIG>",
                "UBW_PROFILES": "<UBW_PROFILES>",
                "UBW_ROOTS": "<UBW_ROOTS>",
                "TAVILY_API_KEY": "<your tavily_api_key>",
                "EXA_API_KEY": "<your exa_api_key>",
                "UBW_MEMORY_URL": "<UBW_MEMORY_URL>",
                "LLM_BASE_URL": "<LLM_BASE_URL>",
                "LLM_API_KEY": "<your llm_api_key>",
                "LLM_MODEL": "<LLM_MODEL>"
            }
        }
    }
}

متغيرات البيئة

  • UBW_CONFIG Optional path to a custom Universal Brute Workpack config JSON.
  • UBW_PROFILES Optional path to a custom profile and deny-list JSON.
  • UBW_ROOTS Optional semicolon-separated filesystem roots for local file tools.
  • TAVILY_API_KEY سري Optional Tavily key for search.web before fallback providers.
  • EXA_API_KEY سري Optional Exa key for search.web before fallback providers.
  • UBW_MEMORY_URL Optional memory or vector service endpoint for memory.search.
  • LLM_BASE_URL Optional OpenAI-compatible base URL for Agent tasks.
  • LLM_API_KEY سري Optional model API key for Agent tasks.
  • LLM_MODEL Optional model name for Agent tasks.

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Plus 不够用，Pro 又用不完？
  2. 能做什么
  3. 接入
  4. 配套 Skill
  5. 工具
  6. 开发
  7. 许可证

Plus 不够用，Pro 又用不完？

接上自己的模型 API，把 Codex 额度留给核心任务。

功能介绍 · 快速接入 · 配套 Skill · 反馈问题

读文件 · 查资料 · 审代码
自选模型分担，Codex 复核交付。

如果用得上，欢迎点个 Star ⭐

UBW 是一个 MCP 服务。Codex 分配任务、限定目录，用户自主配置的大模型通过 API 只负责调用只读工具，返回报告与证据。联网搜索通过配置的搜索服务完成。

Plus 额度不够用，又用不完 Pro？UBW 支持接入自选模型 API，分担读取、搜索和代码审查等任务，让原本交给 Codex 子 Agent 的只读工作走自定义模型的 API 计费。Codex 负责判断、修改和交付，把订阅额度留给核心任务。

更多用法，欢迎探索，也欢迎提交 Issue 或 PR。

能做什么

  • 列目录、找文件、搜索文本、读取文件、查看 Git 差异。
  • 搜索公开网页，保留来源链接。
  • 查看进度、补充指令、暂停、恢复和取消任务。
  • 保存阶段结果；失联或预算耗尽时暂停。

不提供文件写入、Shell 执行或子 Agent 派生。

接入

需要 Node.js ≥ 20.3、DeepSeek API Key；读取 Git 差异需要 Git。

复制 配置示例，将 roots 设为允许读取的项目目录：

{
  "roots": ["D:/projects/example"],
  "search": { "backend": "deepseek" }
}

MCP 客户端配置：

{
  "mcpServers": {
    "ubw": {
      "command": "node",
      "args": ["D:/tools/ubw/src/bridge.js"],
      "env": {
        "UBW_CONFIG": "D:/config/ubw.json",
        "DEEPSEEK_API_KEY": "<API_KEY>"
      }
    }
  }
}

路径改为实际位置。密钥保存在本机配置或环境变量中，不提交到仓库。

配套 Skill

ubw：任务委派、进度跟进和结果复核。使用时将 skills/ubw 目录放入宿主的 Skill 目录。

工具

工具用途
delegate.start分配任务，指定目录、预算和联网权限
delegate.inspect查看进度并续租，可等待状态变化
delegate.control补充指令、暂停、恢复、取消
delegate.result获取完整任务的报告或当前阶段结果

读取的文件内容会发送到 DeepSeek API。联网任务需设置 allowNetwork: true；官方搜索另计 API 用量。

默认租约为 120 秒，需在到期前调用 delegate.inspect。任务记录含文件摘录和报告，保存在 ~/.ubw/tasks；重启后保持暂停。Token 预算用于停止后续请求，不是账户金额上限。

开发

npm test
npm run doctor

已通过 Windows / Node.js 26 的本地模拟测试。真实 API 联调尚未完成。

许可证

Apache-2.0

欢迎按需修改和扩展，也欢迎提交 Issue 或 PR。

الأسئلة الشائعة

ما هو Universal Brute Workpack؟

Stdio-first Agent MCP workpack for local tools, audit chains, search, memory, and pipelines.

كيف أثبّت Universal Brute Workpack؟

يعمل على جهازك. في Claude Code: claude mcp add universal-brute-workpack -e 'UBW_CONFIG=<UBW_CONFIG>' -e 'UBW_PROFILES=<UBW_PROFILES>' -e 'UBW_ROOTS=<UBW_ROOTS>' -e 'TAVILY_API_KEY=<your tavily_api_key>' -e 'EXA_API_KEY=<your exa_api_key>' -e 'UBW_MEMORY_URL=<UBW_MEMORY_URL>' -e 'LLM_BASE_URL=<LLM_BASE_URL>' -e 'LLM_API_KEY=<your llm_api_key>' -e 'LLM_MODEL=<LLM_MODEL>' -- npx -y universal-brute-workpack@0.1.4. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Universal Brute Workpack إلى مفتاح API؟

نعم. يتطلب TAVILY_API_KEY, EXA_API_KEY, LLM_API_KEY، وتضبطها في إعداداته.

هل Universal Brute Workpack مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص Apache-2.0.

من يصون Universal Brute Workpack؟

ينشره haoyun18881-beep. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.