Gs MCP Proxy Pii Redactor

@growthspace-engineering/gs-mcp-proxy-pii-redactor

MCP Proxy with PII Redaction

一个MCP代理，在单个HTTP入口点后聚合多个MCP服务器，具有内置的PII编辑功能。

特性

• 代理多个MCP服务器：通过单个HTTP端点聚合来自许多服务器的工具、提示和资源
• 多种运输方式：支持 stdio, sse，以及 streamable-http 客户端传输
• 服务器传输选项：通过服务器发送事件（SSE）或流式HTTP提供服务
• PII编辑：使用GCS支持的字典和通用模式匹配自动编辑PII
• 工具过滤：允许或阻止每个服务器配置的特定工具
• 认证：使用每台服务器或全局配置进行承载令牌身份验证
• 审计日志：用于编校操作的可选详细审计日志记录
• 灵活配置：带环境变量插值的JSON配置

文档

• IDE设置

- 光标 - 克劳德桌面 - 其他IDE

• 配置 -配置参考和示例
• 用法 -CLI选项、端点、身份验证和工具筛选
• PII补救措施 -Redaction设置和配置
• 部署 -生产部署
• -构建、运行和配置Docker镜像

快速开始

先决条件

• Node.js>=20（或等效的bun或pnpm）

选项1——使用stdio运行（推荐）

通过stdio直接与IDE集成。无需全局安装。

在配置IDE之前，初始化默认配置文件（创建 ~/gs-mcp-proxy/config.json 默认情况下）：

gs-mcp-proxy --init
# or without installing globally
npx -y @growthspace-engineering/gs-mcp-proxy-pii-redactor --init

看 用法 通过以下方式自定义目的地 --init-dest.

• 光标：请参见 docs/ide/cursor.md （stdio部分）
• 克劳德桌面：请参阅 docs/ide/claude.md （stdio部分）
• 其他IDE：请参阅 docs/ide/other.md

选项2——在IDE集成之前本地运行（SSE/HTTP）

1. 全局安装模块：

   npm install -g @growthspace-engineering/gs-mcp-proxy-pii-redactor

1. 初始化默认配置文件（创建 ~/gs-mcp-proxy/config.json 默认情况下）：

   gs-mcp-proxy --init

看 用法 通过以下方式自定义目的地 --init-dest.

1. 运行CLI（有或没有配置文件）：

   gs-mcp-proxy --config ~/gs-mcp-proxy/config.json
   # or (uses ./config.json by default if present)
   gs-mcp-proxy

1. 使用连接IDE mcp-remote （SSE或流式HTTP）：

- 光标：请参见 docs/ide/cursor.md （SSE/HTTP部分） - 克劳德桌面：请参阅 docs/ide/claude.md （SSE/HTTP部分）

开发人员设置（克隆、构建、本地运行）已移至 贡献.md.

最低配置（适用于本地服务器）

{
  "mcpProxy": {
    "baseURL": "http://localhost:8084",
    "addr": ":8084",
    "name": "MCP Proxy with PII Redaction",
    "version": "1.0.0",
    "type": "sse"
  },
  "mcpServers": {
    "github": {
      "transportType": "streamable-http",
      "url": "https://api.githubcopilot.com/mcp/",
      "headers": {
        "Authorization": "Bearer ${GITHUB_TOKEN}"
      }
    }
  }
}

看 配置 以获取完整的配置参考和示例。

测试

# Unit tests
npm test

# E2E tests (requires GITHUB_TOKEN)
export GITHUB_TOKEN=your_token_here
npm run test:e2e

注： 所有E2E测试都需要有效的 GITHUB_TOKEN 环境变量。该测试套件验证了SSE和Streamable HTTP传输选项。

贡献

欢迎投稿！请看 贡献.md 作为指导方针。

该项目遵循 所有贡献者 规范。欢迎任何形式的贡献！

行为准则

该项目遵守行为准则。请阅读 代码_OF_CONDUCT.md 在做出贡献之前。

贡献者

感谢这些了不起的人(表情符号键):

Neil Kalman 💻 💬 📝 📖 🤔 🚇 🚧 🔬

Romario Nijim 🤔 🚧 🔬 💬

shai eliyahu 👀

Gal Amitai 👀

Yevgeni Mumblat 🤔

Utkarsh9571 💻 💡

Mr. Narra Mine 👀

allcontributors[bot] 💻

gr0wth-b0t 💻

Riki Shachor 👀

katerina-semikina 👀

运作原理

当您合并拉取请求时，我们的GitHub Actions工作流会自动：

• 将贡献者添加到 .all-contributorsrc 配置
• 更新此README中的“贡献者”部分
• 使用更改创建提交

您还可以使用以下方式手动添加贡献者：

npm run contributors:add

allcontributors cli将提示您输入贡献详细信息。

致谢

该项目受到以下项目的启发：

• TBXark/mcp代理：一个基于Go的MCP代理服务器，通过单个HTTP端点聚合多个MCP服务器。
• nestjs/nest：一个用于构建服务器端应用程序的渐进式Node.js框架。

许可证

麻省理工学院2025