MCP代理PII脱敏工具

一个聚合多个MCP服务器并通过单一HTTP入口提供服务的代理工具,内置PII(个人身份信息)脱敏功能。

  • by growthspace-engineering
  • TypeScript
  • 本地部署
  • 7 星标
  • 更新于
在 GitHub 查看 growthspace-engineering/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配置

文档

快速开始

先决条件

  • 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.

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

  1. 全局安装模块:
    npm install -g @growthspace-engineering/gs-mcp-proxy-pii-redactor
    
  2. 初始化默认配置文件(创建 ~/gs-mcp-proxy/config.json 默认情况下):
    gs-mcp-proxy --init
    
    看 用法 通过以下方式自定义目的地 --init-dest.
  3. 运行CLI(有或没有配置文件):
    gs-mcp-proxy --config ~/gs-mcp-proxy/config.json
    # or (uses ./config.json by default if present)
    gs-mcp-proxy
    
  4. 使用连接IDE mcp-remote (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 在做出贡献之前。

贡献者

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


💻 💬 📝 📖 🤔 🚇 🚧 🔬

🤔 🚧 🔬 💬

👀

👀

🤔

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