M
MCP 精选目录 CURATED DIRECTORY
已收录 911 个 MCP Server
EN
← 返回目录
T

ThumbGate MCP Server

社区
AI 编码代理的自改进防火墙：在工具执行前拦截风险操作
查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗
分类
开发工具 第 108 / 438
Stars
★ 29 热门
传输方式
stdio（本地进程）
运行环境
Node.js 18+
凭据
无需凭据
许可证
MIT
最近提交
工具数
13
61FMRS · C

ThumbGate 是设计严谨的本地优先门控层：强制路径无 LLM、决策可审计、带 break-glass 恢复和明确的能力边界声明。其价值取决于钩子拦截点——硬拦截仅在支持 PreToolUse 钩子的代理上成立；文档对咨询式集成的局限、估算口径与未交付功能保持诚实。适合需要跨代理共享学习型规则库的团队，不适合只需静态拒绝列表的简单场景。

最强项 · 文档质量 14/20 最弱项 · 可靠性 8/20

可靠性
8/20
安全与权限
13/20
维护活跃度
13/20
文档质量
14/20
安装易用性
13/20
查看各项评分依据
可靠性 8/20
server.json 明确声明了 stdio 传输和固定启动命令（npx -y thumbgate serve），README 也专门提醒不要用 npm start（那是 HTTP API，属于仓库中另一个服务）。但除此之外没有提供该 stdio 服务器自身的工具清单、参数定义或与之对应的测试证据；README 提到的 CI 徽章和 eval/monitor 脚本主要针对'任务结果'子系统，并未证明覆盖了这个 MCP stdio 服务器的初始化和 tool-list 握手路径。按静态审查规则，没有可验证的、覆盖该服务器关键路径的测试证据，可靠性上限为 12，鉴于证据单薄（无工具清单、无该服务器专属测试文件），评为 8。
安全与权限 13/20
环境变量 THUMBGATE_MCP_PROFILE 默认使用最小权限的 'essential' 档位，只有显式设置才会扩展权限，这是良好的最小权限设计信号。README 也坦诚披露：只有检测到的密钥泄露和自我禁用类命令默认硬阻断，其余高危类（rm -rf、force-push、越权编辑、部署）默认仅'警告+记录'，需要设置 THUMBGATE_STRICT_ENFORCEMENT=1 才会阻断；且对 Cursor/Cline/OpenCode 等仅有'建议性' gate_check，代理可以选择无视。这不属于红线情形，因为该服务器本身并不执行这些危险操作，只是对其他工具调用给出裁决，且限制条件已被清楚披露。但由于无法看到实际工具列表/权限范围的源码级验证，也存在通过 thumbgate.ai 的许可证/计费等外部网络面，未给满分。
维护活跃度 13/20
仓库使用 MIT 许可证，npm 包版本号为 1.36.1，显示有持续迭代；README 提及 CI 徽章、Changesets 流程与发布验证文档，显示存在一定的发布治理。但 25 星对应 48 个未关闭 issue，比例偏高，可能意味着问题响应或积压情况不理想，且未提供最近提交时间等佐证。综合判断为'活跃但治理/响应存在缺口'。
文档质量 14/20
README 内容极为详尽，涵盖安装、架构、CLI 参考、内置检查规则、恢复流程（break-glass）、定价与常见问题，并链接了 THREAT_MODEL.md、VERIFICATION_EVIDENCE.md 等文档。但大量篇幅是营销与销售导向内容（定价、企业销售话术、SEO 引流链接），且该仓库包含 3 个 MCP 服务器，README 中提到的诸多工具名称（capture_feedback、gate_check、record_task_outcome 等）未明确区分哪些确实属于 server.json 所声明的这一个 stdio 服务器，存在归属模糊，也没有针对该服务器的正式参数级工具文档。
安装易用性 13/20
manifest 给出了清晰单一的启动方式（npx -y thumbgate serve，stdio 传输），README 专门用一节说明 MCP/注册表安装方式并强调常见误用（npm start 会启动错误的 HTTP 服务）。这方面表达清楚、步骤简单。但按静态审查规则，没有源码内可验证的、覆盖该路径的测试/CI 证据，安装易用性上限为 15；因此在该上限内评为较高但非满分的 13。

静态评测 · 未实际运行收录于 2026-09-07

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件写入 / 删除本地文件执行命令或代码

适合谁

  • 在生产或高影响工作流中大量使用 AI 编码代理、需要外部执行边界的开发者
  • 需要可审计、可检查门控决策的工程/安全/平台团队
  • 希望把反复纠正转化为可复用规则而非靠模型记忆的团队

不适合谁

  • 只想要静态手写拒绝列表的小团队（原生钩子即可）
  • 期望通过门控改变模型生成质量的人（它只在执行前拦截，不改进生成）
  • 无法接受咨询式裁决可能被代理忽略的 Cursor/Cline/OpenCode 用户处理不可逆操作

所需权限

  • 通过 stdio 在本地运行，可读取/写入 ~/.claude 或仓库内 .claude 的配置、钩子与经验库
  • 可写入本地状态目录（.thumbgate/）及 JSONL 日志与回执文件
  • 需要修改代理的 MCP 与 PreToolUse 钩子配置文件
  • 回执相关决策需要 THUMBGATE_HUMAN_REVIEWER_ID 及独立可撤销的人工复核密钥

风险与副作用

  • 咨询式集成（Cursor、Cline、OpenCode、Amp）下代理可能忽略 gate_check 裁决，无法真正阻断不可逆操作
  • 严格模式（THUMBGATE_STRICT_ENFORCEMENT=1）下规则误报可能阻断合法操作，需 break-glass 应急
  • 默认仅为告警模式，多数高风险命令默认并不阻断
  • 仪表盘显示的 token/费用节省为估算值，非实测
  • 经验库含敏感工程信息，按项目安装时必须保持 gitignored
  • 法规行业模板仅为路线图方向，非已交付的合规能力

安装接入

准备工作

运行环境：Node.js 18+

其他可选配置项（2 个）
THUMBGATE_MCP_PROFILE 可选 可选的 MCP 工具配置档覆盖（essential | default | readonly | locked）。不设置时保持出厂的最小权限 essential 配置档；仅在有意扩展工具时设置。
THUMBGATE_STRICT_ENFORCEMENT 可选 设为 1 时对所有匹配的阻断规则保留拒绝判定；默认情况下大多数匹配的门禁只警告并记录而不拦截。

运行 npx thumbgate init 自动检测并接入所支持的代理；或直接以 stdio MCP 服务器运行：npx -y thumbgate serve。可选环境变量 THUMBGATE_MCP_PROFILE（essential | default | readonly | locked）调整工具档位；THUMBGATE_STRICT_ENFORCEMENT=1 开启严格阻断模式。注意：不要用 npm start 作为 MCP 入口，那会启动 HTTP API 而非 stdio 服务器。

.mcp.json 
{"mcpServers":{"thumbgate":{"command":"npx","args":["-y","thumbgate","serve"]}}}

以 Claude Code 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json
{
  "servers": {
    "thumbgate": {
      "command": "npx",
      "args": [
        "-y",
        "thumbgate",
        "serve"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal
claude mcp add thumbgate -- npx -y thumbgate serve

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在客户端配置 {"mcpServers":{"thumbgate":{"command":"npx","args":["-y","thumbgate","serve"]}}} 后，启动客户端并确认 thumbgate 服务器出现，且工具列表中包含 gate_check、capture_feedback 等工具；也可以运行 'npx thumbgate doctor' 对 hooks 和 MCP 接线进行健康检查。

常见排障

  1. 运行 npx thumbgate doctor 检查钩子、MCP 与代理就绪状态
  2. 确认使用 npx thumbgate serve（stdio），而非启动 HTTP API 的 npm start
  3. 更改 MCP 或钩子配置后需重启代理会话以重新加载配置
  4. 若门控误拦恢复所需操作，使用 npx thumbgate break-glass --reason=... 打开短时窗口
  5. 检查 THUMBGATE_STRICT_ENFORCEMENT 与 THUMBGATE_MCP_PROFILE 环境变量是否符合预期
  6. 按项目安装时确认 .claude/memory/feedback/ 已被 gitignore

试试这样问

连接成功后，可以直接对 AI 助手这样说：

  • 检查运行 'rm -rf tests/' 会不会触发任何防护规则
  • 记录一个差评教训：绝不要在生产数据库上执行 DROP
  • 显示当前守护这个仓库的防护规则和教训
  • ThumbGate 到目前为止实际拦截了什么？显示门禁统计和执行矩阵

工具能力 13

gate_check 只读
在工具执行前评估提议的调用，返回 allow/warn/deny 裁决
capture_feedback 写入
将点赞/点踩反馈捕获为结构化本地经验教训
open_feedback_session 写入
开启反馈会话以补充点踩上下文
append_feedback_context 写入
向打开的反馈会话追加具体上下文
finalize_feedback_session 写入
结束反馈会话并从完整对话推断经验教训
record_task_outcome 写入
记录带证据的任务级回执，仅在验证通过且证据齐全时标记为有效
search_lessons 只读
跨本地经验库检索历史教训（Pro 功能）
prevention_rules 只读
列出当前激活的预防规则
展开其余 5 个工具
get_reliability_rules 只读
获取可靠性规则列表
gate_stats 只读
查看门控统计信息
enforcement_matrix 只读
查看实际阻断情况的执行矩阵
get_branch_governance 只读
查看分支/发布治理状态
approve_protected_action 写入
授予带作用域和过期时间的受保护操作审批

使用场景

在 git push --force 触达受保护分支前予以标记或阻断
将重复出现的失败（如误删测试目录、生产库 DROP）转化为预防规则
默认硬阻断检测到的密钥泄露
跨多个代理共享同一套本地经验与规则存储
用 break-glass 窗口在误拦时进行 5 分钟内的应急恢复

支持客户端

Claude Code
Claude Desktop部分支持
Cursor部分支持
Codex
Gemini CLI
Cline部分支持
OpenCode部分支持
Amp部分支持

依据项目文档列出，未经本站实测。

详细介绍

ThumbGate 是一款本地优先的 Pre-Action Checks 引擎，通过 PreToolUse 钩子在 AI 编码代理执行工具调用前评估提议操作。它以 MCP stdio 服务器形式运行，捕获点赞/点踩反馈为本地经验教训，将重复失败提升为预防规则，并默认硬阻断检测到的密钥泄露以及直接关闭或绕过自身的命令；其他高风险操作（如 rm -rf、强推、fetch-and-run）默认告警并记录，设置 THUMBGATE_STRICT_ENFORCEMENT=1 后所有匹配的阻断规则改为拒绝执行。门控决策完全确定性（字面/AST 模式匹配加本地 bge-small 向量检索），不调用任何 LLM。支持 Claude Code、Codex、Gemini CLI 获得硬拦截，Cursor、Cline、OpenCode、Amp 等仅为咨询式 gate_check。免费层每日 2 次反馈捕获（共 10 次）、最多 3 条自动提升的预防规则；Pro 19 美元/月解锁无限规则、经验检索和个人仪表盘。MIT 许可。

同类可选方案

Context7 80 · B

Upstash 官方维护，为 AI 编码助手提供实时更新的第三方库文档

★ 63.3k · 工具数 2 与当前对比 →
与其他 MCP 横向对比

源版本 e088a6d6df56 数据同步于 2026-10-19 查看 FMRS 评分方法