de en es ja ko ru zh

approval-gate-mcp

Name: approval-gate-mcp
Author: WillyV347

by WillyV347

Overview Schema Source Related Servers Discussions Admin

Python

Remote

approval-gate-mcp

一个 MCP 服务器，为长时间运行的自主进程加上一道人工审批门，并提供实际与之共处所需的运维工具：状态、日志、重启、热重载参数，以及它已完成操作的摘要。

基于 FastMCP 构建，可与任何 MCP 客户端配合使用。

问题

一个自主行动的进程，在它的某个动作产生重大影响之前都很有用。常见的两种应对方式都不好：关掉它，你会失去它所有做得好的部分；任由它运行，你只能事后才知道发生了什么。

审批门是第三种选择。进程在无人值守的情况下继续运行，但当它想要执行你标记为有重大影响的动作时，它会写下一份提案并继续推进，而不是执行该动作。你随时可以在已经打开的任意 MCP 客户端中审查提案并批准或拒绝。进程会在下一个周期获取你的决定。

双方互不阻塞。中间没有任何服务。契约就是两个 JSON 文件。

  process                            you
     |                                |
     |-- writes proposal ----> pending.json
     |                                |
     |                          list_pending_approvals
     |                          approve(0) / reject(1)
     |                                |
     |<-- reads on next cycle -- approved.json
     |
     |-- acts, appends to records.json

Related MCP server: conduit-mcp

工具

审批门

工具	功能
`list_pending_approvals`	所有等待决定的提案及其全部字段
`approve(index)`	将一个提案移入已批准文件
`reject(index)`	丢弃一个提案

进程控制

工具	功能
`process_status`	是否在运行、PID、运行时间、CPU、内存、磁盘、最后一行日志
`process_logs(lines)`	查看日志文件尾部
`restart_process`	通过你的启动脚本重启，以分离方式运行，因此 SSH 会话结束后仍然存活
`run_command(cmd)`	一次性检查的应急通道

记录

工具	功能
`record_summary(n)`	总数、已解决与未解决对比、按类型细分、最近条目
`record_dashboard`	更宽的表格视图，加上当前未解决的记录及其暴露程度

参数 — 仅在 PARAMS_SCHEMA 指向你的清单时注册

工具	功能
`list_params`	此部署声明的可调参数，以及当前被覆盖了哪些
`set_param(name, value)`	写入一个覆盖值，并根据你的清单进行校验
`clear_param(name)`	移除一个覆盖值，或全部移除

链 — 仅在 EVM_RPC_URL、WALLET_ADDRESS 和 TOKEN_CONTRACT 都已设置时注册

工具	功能
`wallet_balance`	只读查询监控地址的 ERC-20 和原生代币余额。不会签署任何内容

安装

git clone https://github.com/WillyV347/approval-gate-mcp
cd approval-gate-mcp
pip install -r requirements.txt
cp .env.example .env      # then edit it

在接入客户端之前，先在检查器中试用：

fastmcp dev server.py

然后注册它。对于读取 JSON 配置的客户端：

{
  "mcpServers": {
    "approval-gate": {
      "command": "python3",
      "args": ["/absolute/path/to/approval-gate-mcp/server.py"],
      "env": {
        "VPS_HOST": "your.host.or.ip",
        "VPS_USER": "your-ssh-user",
        "PROCESS_DIR": "/srv/my-process",
        "PROCESS_MATCH": "my_process.py",
        "PARAMS_SCHEMA": "/absolute/path/to/params.schema.json"
      }
    }
  }
}

VPS_HOST、VPS_USER 和 PROCESS_DIR 没有默认值。 如果缺少这些变量，服务器会以清晰的错误信息退出。一个静默回退到作者硬编码主机的监控工具本身就是个 bug，因此本服务器拒绝猜测。

身份验证就是你现有的 SSH 配置。服务器调用系统中的 ssh 可执行文件，因此 SSH agent、硬件密钥，以及提供了 agent 支持的密码管理器都能无需修改地工作。它自己从不读取私钥。

你的进程需要实现的契约

进程侧需要三样东西，它们都不需要任何库。

1. 记录。 追加到一个 JSON 数组。四个键如果存在会被解析，其他所有内容都会原样保留：

[
  {
    "id": "job-1041",
    "record_type": "reindex",
    "resolved": true,
    "outcome": "win",
    "cost": 4.25,
    "result": 11.80,
    "label": "nightly reindex, shard 3"
  }
]

2. 提案。 以审批模式运行时，写入这里而不是执行动作：

{
  "proposals": [
    {
      "id": "job-1042",
      "label": "reindex shard 7",
      "action": "reindex",
      "cost": 6.00,
      "created_at": "2026-08-18T22:14:07Z"
    }
  ]
}

你包含的每个字段都会被显示。服务器没有提案的 schema，也不想要一个。

3. 轮询已批准文件。 每个周期读取 approved.json，对其中的内容执行动作，然后清空它。大致如下：

approved = read_json(APPROVED_FILE) or {"proposals": []}
for proposal in approved["proposals"]:
    execute(proposal)
write_json(APPROVED_FILE, {"proposals": []})

服务器端的顺序是刻意为之的。做出决定时，会先将提案从 pending.json 中移除，然后写入 approved.json，因此决定执行到一半时的故障模式是提案被丢弃，而绝不会是动作被重复执行。

参数，以及为什么本仓库中没有参数

热重载只有在服务器知道哪些参数可调时才有用，而把某个部署的参数硬编码进共享工具会让它变成单一用途。所以你在清单中声明自己的参数，并让 PARAMS_SCHEMA 指向它：

{
  "poll_interval_seconds": { "type": "int",  "description": "Seconds between work cycles" },
  "max_concurrent_jobs":   { "type": "int",  "description": "Jobs in flight at once" },
  "dry_run":               { "type": "bool", "description": "Plan work but do not execute" },
  "approval_mode":         { "type": "bool", "description": "Queue proposals instead of acting" }
}

支持的类型有 int、float、bool、str、dict 和 list。set_param 会据此进行强制转换和校验，并拒绝任何无法转换的值。没有清单时，参数工具根本不会注册，这比暴露一个没有任何校验依据的写入路径要好。

params.schema.json 已被 gitignore，因为你的调优配置属于你自己。params.schema.example.json 作为起点随仓库提供。

让进程在启动时读取覆盖文件；如果你希望更改无需重启即可生效，则每个周期都读取：

overrides = read_json(PARAMS_FILE) or {}
poll_interval = overrides.get("poll_interval_seconds", POLL_INTERVAL_DEFAULT)

示例会话

> is it running?

  Process RUNNING

  PID:      31882
  Uptime:   14h 22m (51720s)
  CPU:      0.6%
  Memory:   84.3 MB
  Disk:     212M

  Last log: 2026-08-18 22:03:11 cycle complete, 2 proposals queued

> anything waiting on me?

  2 proposal(s) awaiting approval

  --- Proposal #0 ------------------------------
    id:           job-1042
    label:        reindex shard 7
    action:       reindex
    cost:         6.00
    created_at:   2026-08-18T22:14:07Z

  --- Proposal #1 ------------------------------
    id:           job-1043
    label:        reindex shard 12
    action:       reindex
    cost:         6.00
    created_at:   2026-08-18T22:14:07Z

  Use approve(index) or reject(index) to decide.

> approve 0, reject 1

  Approved and queued for execution: reindex shard 7
  Rejected and removed: reindex shard 12

上面的输出仅供示意。

安全说明

run_command 会在远程主机上运行任意 shell 命令。它存在的原因是，另一种选择归根结底还是要打开终端，但它是这里最危险的工具。请将 SSH 用户的权限范围限定在其实际所需范围内，而不是什么都用 root 运行。
wallet_balance 是只读的，从不接触密钥。如果你没有配置它，它就不存在。
本仓库不存储任何凭据。RPC URL 在路径中携带服务商密钥，因此请把 EVM_RPC_URL 放在环境中，而不是放进配置文件。
StrictHostKeyChecking 设置为 accept-new：未知主机在首次连接时会被信任，已变更的主机密钥仍然会失败。如果你想要更严格的行为，请将其设置为 yes 并预先填充 known_hosts。

许可证

MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivitySlowing

ResponsivenessNo issues

Resources

GitHub Repository

Need Help?

Related Servers

Related MCP Connectors

PlanWrightOAuth
tools.planwright
Control plane for autonomous software labor. Agents claim objectives over MCP with audit trail.
Project Management Autonomous Agents
27
MANDATE Credential Broker B
io.github.projetnanocorp
MCP server for mandates, delegation, policy-gated execution, credential grants, and audit.
Security
111
runtime
com.formatho
Self-hosted MCP server: 26 deterministic dev, security, and EVM tools.
Developer Tools Blockchain Security
1
clianythingharness-mcp
com.clauxel.clianythingharness
A paid remote MCP for CLI tool MCP, built to return verdicts, receipts, usage logs, and audit-ready
Command Line Monitoring
21

Related MCP Servers

governed-mcp
Security Autonomous Agents Agent Orchestration
rsiraj0
F
license
Not graded
quality
D
maintenance
MCP server that enforces governance on agentic decisions with auditable evidence records, providing tools for understanding, calibrating confidence, and navigating handoffs based on policy.
Updated 3 months ago (2026-07-07 21:40 UTC)
-
conduit-mcp
Finance
IUMvuyo
A
license
Not graded
quality
C
maintenance
A governance-layer MCP server that gates AI writes to systems of record, requiring human signatures and providing a tamper-evident audit trail. It offers read, propose, approve, commit, and audit tools, with demo and Xero backends.
Updated 2 months ago (2026-08-02 08:31 UTC)
69 npm
MIT
approval-gate
Security Autonomous Agents
yulinlina
A
license
Not graded
quality
C
maintenance
MCP server that provides human-in-the-loop approval for risky AI agent actions, with durable state and audit logs.
Updated 2 months ago (2026-08-07 07:31 UTC)
MIT
Procheiron
Knowledge & Memory Security
logotheusneuro-cpu
A
license
Not graded
quality
A
maintenance
MCP server that adds a trust layer to AI agent memory, enforcing independent review and tamper-evident audit chains for any memory store. It provides tools to search, get, propose, and promote memories under governance rules.
Updated 2 months ago (2026-08-11 12:12 UTC)
37 PyPI
MIT

approval-gate-mcp

问题

工具

安装

你的进程需要实现的契约

参数，以及为什么本仓库中没有参数

示例会话

安全说明

许可证

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

governed-mcp

conduit-mcp

approval-gate

Procheiron