Universal Brute Workpack

io.github.haoyun18881-beep由 GitHub 帳號 haoyun18881-beep 發布v0.1.4更新於 Oct 24, 2026

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

已驗證STDIO僅桌面網頁搜尋與抓取開發者工具AI 與機器學習

概覽

AI 產生的概覽

本機 stdio MCP 工作包，將唯讀的檔案、搜尋與程式碼審查工作交給使用者自選的模型 API，並提供任務控制與報告。

可以做什麼
在限定目錄內列出目錄、尋找檔案、搜尋文字、讀取檔案並檢視 Git 差異，網頁搜尋會保留來源連結，結果以階段報告與證據形式保存。分派任務時可指定目錄、預算與網路權限，之後檢視進度、續租、補充指令、暫停、恢復或取消，並取得完整報告或目前階段結果。不提供檔案寫入、Shell 執行或子 Agent 派生。
適用情境
適合想把讀取、搜尋與程式碼審查等唯讀工作交由自選模型 API 計費、把訂閱額度留給核心任務的情境，也適合需要保留任務紀錄並在預算耗盡時暫停的流程。
執行需求
以 Node.js 套件形式在本機透過 stdio 執行，需要 Node.js 20.3 以上版本；檢視 Git 差異需要 Git。委派任務需要模型 API 金鑰，Exa 或 Tavily 搜尋金鑰為選用。透過 UBW_CONFIG、UBW_ROOTS、LLM_API_KEY、LLM_BASE_URL、LLM_MODEL 等環境變數與設定檔指定允許讀取的目錄。
安裝前請注意
讀取的檔案內容會傳送到所設定的模型 API，網路搜尋則經由第三方搜尋服務。金鑰應保存在本機設定或環境變數中，不要提交到儲存庫。任務的網路權限須明確開啟，官方搜尋另計 API 用量。任務紀錄含檔案摘錄與報告，保存在使用者主目錄下。README 說明真實 API 聯合測試尚未完成。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Universal Brute Workpack，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

[UBW — Universal Brute Workpack]

Plus 不够用，Pro 又用不完？

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

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

[GitHub Stars] [Node.js ≥20.3] [Codex Skill] [Apache-2.0 License]

读文件 · 查资料 · 审代码
自选模型分担，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 设为允许读取的项目目录：

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

MCP 客户端配置：

json
{  "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 预算用于停止后续请求，不是账户金额上限。

开发

sh
npm testnpm run doctor

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

许可证

Apache-2.0

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

來源：README.md，提交 73727ee

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.1.4最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分