Skip to main content
Glama
Huan-zhaojun

mcp-safe-proxy

by Huan-zhaojun
OverviewSchemaRelated ServersScoreDiscussions
JavaScript
Local

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，导致每次操作都弹审批，严重影响自动化体验。

工作原理

在 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 工具 destructive + openWorld

✅

文件与代码

Filesystem MCP, GitHub MCP

写入/删除操作 destructive

✅

通信协作

Notion MCP, Slack MCP, Google Workspace MCP

非 GET 操作 destructive

✅

DevOps

Docker MCP

容器操作

⬜

通用规则：只要 MCP Server 的工具声明了 destructiveHint: true 或 openWorldHint: true，就会触发 Codex 审批，mcp-safe-proxy 就能解决。

详见 兼容 MCP Server 完整列表。

相关文档

License

MIT

This server cannot be installed

A
license - permissive license
-
quality - not tested
C
maintenance

How are these scores calculated?

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Huan-zhaojun/mcp-safe-proxy'

If you have feedback or need assistance with the MCP directory API, please join our Discord server