OpenAI Secure MCP Tunnel

一个基于 TypeScript 的 MCP 文件工具服务，通过 OpenAI Tunnel Client 将本地 stdio MCP 服务安全暴露给工作区。

功能

• read：读取工作区内的文本文件

• write：创建或覆盖工作区内的文本文件

• edit：精确替换文件内容

• bash：在工作区内执行 PowerShell 命令

文件工具会限制路径必须位于工作区目录内。

Related MCP server: notion-local-ops-mcp

技术栈

• Node.js 24+

• pnpm 11

• TypeScript

• pnpm workspace + Turborepo

• Vite Plus（Oxfmt、Oxlint、类型检查）

目录结构

apps/mcp-server          MCP 服务入口
packages/pi-adapter      文件和命令工具适配层
packages/types           共享类型
scripts/start-tunnel-client  Tunnel Client 启动脚本和配置

快速开始

安装依赖：

vp install

首次配置

1. 打开 Tunnels 管理页面，创建 Tunnel，将生成的 Tunnel ID 填入 CONTROL_PLANE_TUNNEL_ID。

2. 打开 API Keys 页面，创建 API Key，将生成的 Key 填入 CONTROL_PLANE_API_KEY。

3. 在项目根目录创建 .env.local：

CONTROL_PLANE_TUNNEL_ID=tunnel_...
CONTROL_PLANE_API_KEY=sk-...

下载 Tunnel Client

请从 OpenAI 控制台的 Tunnels 管理页面 下载与你的系统匹配的 tunnel-client，并将 Windows 可执行文件放到：

scripts/start-tunnel-client/tunnel-client.exe

也可以查看 OpenAI tunnel-client 仓库 获取文档和源码。下载后可先检查配置：

.\scripts\start-tunnel-client\tunnel-client.exe doctor `
  --config .\scripts\start-tunnel-client\tunnel-client.yaml `
  --explain

启用 Vite Plus 提交前检查：

pnpm setup:hooks

启动 Tunnel：

pnpm start-tunnel

Tunnel Client 的本地运维地址：

• 健康检查：http://127.0.0.1:9810/healthz

• 就绪检查：http://127.0.0.1:9810/readyz

• 指标：http://127.0.0.1:9810/metrics

• 管理界面：http://127.0.0.1:9810/ui

本地 Tunnel 启动后，打开 ChatGPT Plugins，在其中添加对应的 Plugin。

开发命令

pnpm format        # 格式化代码
pnpm lint          # 静态检查
pnpm quality       # 格式化、lint 和类型检查
pnpm check         # workspace 类型检查
pnpm build         # 构建全部 workspace
pnpm ci            # CI 全量检查

也可以单独启动 MCP 服务：

pnpm start-mcp-server

请勿将 .env.local、API Key 或 Tunnel 凭据提交到 Git。