Universal Brute Workpack

本地服务

github.comAI 与智能体05 周前更新

代码仓库访问官网

关于 Universal Brute Workpack

Universal Brute Workpack 是一个以 stdio 为主的 MCP 服务，可将只读文件、搜索和代码审查任务委派给用户配置的模型 API。它面向希望让 Codex 负责判断与交付、同时保留任务报告和证据的工作流。

主要功能

01列出并搜索文件和文本
02读取文件并查看 Git 差异
03搜索公开网页并保留来源链接
04控制委派任务进度
05保存阶段结果并在受限时暂停

适用场景

01委派只读代码库审查
02搜索公开资料并保留链接
03在 Token 预算限制下暂停和恢复任务

MCP 相关

向 MCP 客户端提供任务委派与控制工具，包括启动、检查、控制任务和获取结果。用户配置的模型 API 执行只读工具调用；不支持写文件、执行 Shell 或派生子 Agent。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "haoyun18881-beep-universal-brute-workpack": {
      "command": "npx",
      "args": [
        "-y",
        "universal-brute-workpack"
      ],
      "env": {
        "UBW_CONFIG": "<UBW_CONFIG>",
        "UBW_PROFILES": "<UBW_PROFILES>",
        "UBW_ROOTS": "<UBW_ROOTS>",
        "TAVILY_API_KEY": "<TAVILY_API_KEY>",
        "EXA_API_KEY": "<EXA_API_KEY>",
        "UBW_MEMORY_URL": "<UBW_MEMORY_URL>",
        "LLM_BASE_URL": "<LLM_BASE_URL>",
        "LLM_API_KEY": "<LLM_API_KEY>",
        "LLM_MODEL": "<LLM_MODEL>"
      }
    }
  }
}

启动命令npx -y universal-brute-workpack

需要配置的环境变量

UBW_CONFIGOptional path to a custom Universal Brute Workpack config JSON.

UBW_PROFILESOptional path to a custom profile and deny-list JSON.

UBW_ROOTSOptional 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_URLOptional memory or vector service endpoint for memory.search.

LLM_BASE_URLOptional OpenAI-compatible base URL for Agent tasks.

LLM_API_KEY密钥Optional model API key for Agent tasks.

LLM_MODELOptional model name for Agent tasks.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmuniversal-brute-workpack0.1.4stdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

来自项目 README

UBW — Universal Brute Workpack

Plus 不够用，Pro 又用不完？

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

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

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

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

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

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

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

通过 UBW 接入自选模型 API，分担读文件、查资料和审代码的工作，把 Codex 订阅额度留给判断、修改和交付。

UBW 任务分工：将代码审查、文件检索和资料搜索交给外部模型，Codex 额度节省目标 30%，外部 API 按量计费。

能做什么

列目录、找文件、搜索文本、读取文件、查看 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 预算用于停止后续请求，不是账户金额上限。