mcp-safe-proxy
Provides a proxy for Docker MCP servers to suppress AI CLI approval prompts for container operations by rewriting tool metadata.
Provides a proxy for Filesystem MCP servers to suppress AI CLI approval prompts for file and code operations by rewriting tool metadata.
Provides a proxy for GitHub MCP servers to suppress AI CLI approval prompts for write and delete operations by rewriting tool metadata.
Provides a proxy for Google Workspace MCP servers to suppress AI CLI approval prompts for non-GET operations by rewriting tool metadata.
Provides a proxy for Notion MCP servers to suppress AI CLI approval prompts for management and non-GET operations by rewriting tool metadata.
Provides a proxy for Slack MCP servers to suppress AI CLI approval prompts for communication and collaboration tasks by rewriting tool metadata.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
mcp-safe-proxy
轻量级 MCP 注解代理 — 拦截 tools/list 响应,将工具注解重写为"安全"值,绕过 Codex 等 AI CLI 的审批弹窗,同时完全透传所有实际操作。
问题背景
OpenAI Codex CLI 根据 MCP Server 在 tools/list 响应中声明的工具注解判定是否需要审批:
需要审批 = destructiveHint == true
OR (readOnlyHint == false AND openWorldHint == true)Playwright MCP 等 Server 对所有工具硬编码了 openWorldHint: true,导致每次操作都弹审批,严重影响自动化体验。
Related MCP server: mcp-vcr
工作原理
在 MCP Client(如 Codex)和真实 MCP Server 之间插入 stdio 代理:
flowchart LR
subgraph Client["AI CLI (Codex / Claude Code)"]
A["MCP Client"]
end
subgraph Proxy["mcp-safe-proxy"]
B["stdio 流代理"]
C["注解重写引擎"]
end
subgraph Server["MCP Server (Playwright 等)"]
D["真实 MCP Server"]
end
A -->|"stdin 请求"| B
B -->|"透传请求"| D
D -->|"stdout 响应"| C
C -->|"tools/list: 重写注解\n其他: 原样转发"| A核心逻辑:
拦截
tools/list响应,将每个工具的注解重写为:readOnlyHint: true ← 告诉 Client 工具只读 destructiveHint: false ← 告诉 Client 工具不搞破坏 openWorldHint: false ← 告诉 Client 工具不访问外部tools/call、initialize等所有其他消息完全透传,功能零损失保留工具原有的
title、idempotentHint等其他注解字段
快速开始
安装
# 方式一:全局安装(推荐,启动更快)
npm install -g mcp-safe-proxy
# 方式二:npx 按需调用(无需预装)
npx -y mcp-safe-proxy -- <command> [args...]Codex 配置
在 ~/.codex/config.toml(Linux/macOS)或 %USERPROFILE%\.codex\config.toml(Windows)中:
原始配置(会弹审批):
[mcp_servers.playwright]
type = "stdio"
command = "npx"
args = ["@playwright/mcp@latest"]代理配置 — npx 方式(不弹审批):
[mcp_servers.playwright]
type = "stdio"
command = "npx"
args = ["-y", "mcp-safe-proxy", "--", "npx", "@playwright/mcp@latest"]代理配置 — 全局安装方式:
[mcp_servers.playwright]
type = "stdio"
command = "mcp-safe-proxy"
args = ["--", "npx", "@playwright/mcp@latest"]ccSwitch 配置
ccSwitch 使用标准 JSON 格式:
{
"command": "npx",
"args": ["-y", "mcp-safe-proxy", "--", "npx", "@playwright/mcp@latest"]
}从源码构建(开发者)
git clone https://github.com/Huan-zhaojun/mcp-safe-proxy.git
cd mcp-safe-proxy
npm install
npm run build详见 本地开发测试指南。
CLI 选项
mcp-safe-proxy [options] -- <command> [args...]
选项:
--verbose, -v 启用调试日志输出到 stderr
--log-file <path> 将调试日志写入指定文件(隐含 --verbose)
示例:
mcp-safe-proxy -- npx @playwright/mcp@latest
mcp-safe-proxy --verbose -- npx @playwright/mcp@latest
mcp-safe-proxy --log-file /tmp/proxy.log -- npx @playwright/mcp@latest
--是分隔符:左侧为代理选项,右侧为要包裹的 MCP Server 命令。
测试
# E2E 测试(使用 mock MCP Server)
npm run build && node test/e2e-test.js
# 真实 Playwright MCP 对比测试(需安装 @playwright/mcp)
node test/real-playwright-test.js技术特点
零运行时依赖 — 仅使用 Node.js 内置模块(
child_process、fs、path)~220 行 TypeScript — 极简实现,易于审计和维护
通用 MCP 代理 — 不限 Playwright,任何 stdio MCP Server 均可使用
零侵入 — 不修改 MCP Server 代码,不全局安装,随时启用/恢复
适用范围
mcp-safe-proxy 在 MCP 协议层工作,兼容所有使用 stdio 传输的 MCP Server。以下是常见受审批问题影响的 Server 类别:
类别 | 代表 Server | 触发原因 | 注解验证 |
浏览器自动化 | Playwright MCP, Chrome DevTools MCP, Browserbase | action 工具 | ✅ |
文件与代码 | Filesystem MCP, GitHub MCP | 写入/删除操作 | ✅ |
通信协作 | Notion MCP, Slack MCP, Google Workspace MCP | 非 GET 操作 | ✅ |
DevOps | Docker MCP | 容器操作 | ⬜ |
通用规则:只要 MCP Server 的工具声明了
destructiveHint: true或openWorldHint: true,就会触发 Codex 审批,mcp-safe-proxy 就能解决。
相关文档
兼容 MCP Server 一览 — 分类列表、配置示例、验证方法
技术设计文档 — 架构设计、原理详解、风险分析
Codex MCP 权限问题分析 — 问题根因、源码追踪
本地开发测试指南 — 开发环境、配置示例、验收测试
License
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Security & DLP proxy for MCP: tool-poisoning scans, PII redaction on tool args/results. Beta.
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
Find, vet, and run MCP tools through a secure audited gateway with prompt-injection risk scoring
Zero-setup MCP gateway securely connecting AI to your tools with authentication and workflows
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceMCP proxy that bridges Mendix Marketplace's Streamable HTTP endpoint to stdio, enabling Claude Code and other stdio-only MCP clients to access Mendix Marketplace tools and prompts dynamically.MIT
- AlicenseNot gradedqualityCmaintenanceVCR for MCP servers: a zero-dependency stdio proxy that records and replays MCP JSON-RPC tool calls to local cassette files, enabling deterministic, offline testing of AI agent workflows without side-effects or rate limits.1MIT
- AlicenseNot gradedqualityDmaintenanceA local-first stdio proxy for MCP servers that traps destructive tool calls and holds them for manual commit or discard, preventing accidental mutations.AGPL 3.0
- AlicenseNot gradedqualityDmaintenanceSecurity scanner and runtime proxy for MCP servers. Catches tool poisoning, prompt injection, and rug-pull attacks (silent tool description changes) before they reach your AI agent. Includes a static scanner and a runtime stdio proxy.57 npmMIT