Ratchet

io.github.iversonwuwei由 GitHub 帳號 iversonwuwei 發布v0.12.1更新於 Oct 24, 2026

Read-only tools to inspect your agent setup: list MCP servers, flag unpinned ones, test a policy.

已驗證STDIO僅桌面開發者工具安全與監控AI 與機器學習

概覽

AI 產生的概覽

Ratchet 檢查本機 agent 設定，列出 MCP 伺服器、標出未鎖版本者，並依觀測到的工具使用編譯最小權限原則。

可以做什麼
它在本機執行，讀取 harness 設定以列出已安裝的 MCP 伺服器並標出未鎖定版本者，且不執行任何內容。它可選擇連線伺服器以列舉工具，蒐集真實呼叫紀錄以找出從未使用的工具，並編譯三態原則（allow、approve、deny），每條附判定依據。它也能產出交付目錄，內含原則、報告與逐檔 sha256 清單，以及收貨方無須安裝 Ratchet 即可執行的獨立驗證器。作為 MCP 伺服器，它透過 stdio 暴露 ratchet_scan、ratchet_policy 與 ratchet_check。
適用情境
當你需要了解 agent 實際擁有哪些 MCP 伺服器與工具，或需要把觀測到的 agent 行為轉成可複核的最小權限原則時使用。它適合收貨方必須獨立驗證結果、而非信任寄送方日誌的稽核情境。
執行需求
在 macOS 或 Linux（amd64 或 arm64）上以本機程序執行，可透過安裝腳本、Homebrew、容器映像或 Claude Desktop 一鍵安裝包取得；打包的執行檔不需要 Node 或 Python 執行環境。未宣告任何帳號、API 金鑰或環境變數。選用的 introspection 模式會連線已設定的 MCP 伺服器，驗證腳本需要 Python 3。
安裝前請注意
掃描為唯讀，但 introspection 會連線已設定的 MCP 伺服器，觀測會蒐集真實呼叫紀錄，其中可能含敏感的工具參數，請將這些產物保留在本機。能力判定基於名稱與描述的啟發式規則，會雙向出錯，依賴前請先複核原則。它不是沙箱，執行時不會攔截呼叫。回饋內容僅整理供你複製，不會自動傳送遙測。

安裝

在 SourceWeft 中

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

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

其他 MCP 客戶端

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

README

Ratchet

从 agent 的真实行为编译最小权限策略，并给出收货方能自己验证的证据。

bash
curl -fsSL https://github.com/suhui-organization/ratchet/releases/latest/download/install.sh | sh

macOS / Linux 上也可以用 Homebrew（formula 钉住每个平台的 sha256）：

bash
brew install suhui-organization/tap/ratchet

Claude Desktop 用户可以直接装本地 server（一键安装包，不需要命令行）：

下载 ratchet-0.12.0.mcpb 并打开它，Claude Desktop 会完成安装。包内是四个平台的原生二进制 + 一份 manifest.json （MCPB 规范），不需要 Node 或 Python 运行时。

Linux / macOS（amd64 · arm64）。装完先跑这一条——只读配置，不执行任何东西：

bash
ratchet scan --home ~

它会在十秒内告诉你：这台机器上有几个 MCP server，其中几个没锁版本。 （我自己的机器：16 个里 12 个没锁。）

棘轮只能往一个方向转：权限可以收紧，放宽必须显式。

这是什么

一个跑在你自己机器上的工具：它读 agent 用到的工具清单， 编译出一份最小权限策略，再把这次审计的产物打成一份 收货方不需要信任你、也不需要装任何东西就能验证的交付目录。

这不是什么

  • 不是沙箱、不是容器运行时；
  • 不是 prompt 内容过滤器；
  • 不是企业控制台（不做 dashboard、不做多租户、不做 SaaS 依赖）；
  • 不要求你把日志传到哪里去。

为什么值得存在

市场上的产品要么让你自己手写策略（Cedar / CEL / 自然语言）， 要么要你相信它的日志。Ratchet 做的是这两件之间缺失的一步： 策略由观测编译，证据由收货方自己算哈希。

一个例子

bash
# 1) 编译：从工具清单得到一份保守的最小权限策略ratchet policy draft --from examples/inventory.json --out policy.json
# 2) 出交付物：报告 + 逐文件 sha256 清单ratchet-report build --dir ./delivery --policy policy.json
# 3) 收货方验证（不需要装 ratchet）python3 verify.py ./delivery

仓库结构

目录语言是什么
cmd/ internal/Go机器上的引擎：工具清单 → 能力判定 → 最小权限策略。编译成单个静态二进制，目标机器不需要任何运行时
service/Python交付物侧：合规映射、sha256 清单、以及只用标准库的独立验证器
web/Nuxt 4 + Vue 3 + Tailwind公开页面：落地页 + 收货方在浏览器里自己算哈希的验证页
docs/—设计与计划（DESIGN.md / PLAN.md / DECISIONS.md）

状态

0.12.0 — developer preview，链路已经整条打通（本机实测：16 个 MCP server、 12 个未锁版本、164 个工具、策略 allow 43 / approve 106 / deny 15）：

命令做什么
ratchet scan [--introspect] [--share page.html]读 harness 配置列出 MCP server（只读，不执行）；加 --introspect 才连上去列工具
ratchet ingest / observe采集真实调用（hook 出错静默退出），并对照清单看出哪些工具从没被用过
ratchet policy draft / check编译三态策略（每条带判定依据），并试跑一次假设调用
ratchet deliver / report build一条命令出交付目录：策略 + 报告 + sha256 清单
ratchet mcp以 stdio MCP server 形态跑（ratchet_scan / ratchet_policy / ratchet_check）
ratchet feedback把去标识化结果整理成 issue 正文供你复制；没有遥测，不会自动发

拿到它的方式：curl -fsSL https://github.com/suhui-organization/ratchet/releases/latest/download/install.sh | sh、 brew install suhui-organization/tap/ratchet、容器 ghcr.io/suhui-organization/ratchet， 或官方 MCP Registry 里的 io.github.iversonwuwei/ratchet。

清楚的边界：能力判定是名称/描述的启发式，会双向出错（仓里有两条已知误判的测试）； 它不是沙箱、运行时不拦调用；判定不了的会单独列出来请人确认，而不是猜一个结论。 详见 docs/PLAN.md 与 docs/DELIVERY-0.14.0.md。

许可证

Apache-2.0，见 LICENSE。

开发

bash
make test          # 三端全部测试make go-testmake py-testmake web-test

來源：README.md，提交 0b546b9

工具

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

版本歷史

3
  1. v0.12.1最新Sep 20, 2026
  2. v0.12.0Sep 19, 2026
  3. v0.11.0Sep 19, 2026

評分

已滿足適用檢查項的 50%

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

  • 近 30 天內可連通25 分

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

  • 已宣告認證方式10 分

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

  • 已列出工具15 分

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

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