
Privacyscrubber Mcp
io.github.moxno由 GitHub 账号 moxno 发布v2.2.5更新于 Oct 24, 2026
Zero-Trust PII & secrets sanitizer for AI agents with in-memory local redaction.
概览
在文本和文件发送到远程大模型之前,于本地脱敏 PII、密钥和凭据,并在回复中还原。
- 可以做什么
- 作为本地 stdio MCP 服务器运行,在内存中遮蔽敏感数据。工具包括 sanitize_text 与 reveal_text,用于对提示词和回复进行标记化与还原;sanitize_file 与 guard_read_file 用于读取并脱敏本地文件;guard_exec 用于执行命令并遮蔽输出;guard_git_diff 用于脱敏差异;guard_apply_patch 用于将还原内容写回磁盘;create_agent_rules 用于生成代理规则文件;check_status 用于查看许可与用量;generate_procurement_memo 用于生成合规业务说明。检测配置涵盖通用、开发、医疗、法律与合规场景。
- 适用场景
- 当需要把源代码、日志、.env 文件、数据库导出或客户数据发送到云端大模型,并希望先遮蔽凭据与个人数据时适用。适合使用 Cursor、Claude Desktop、Windsurf、VS Code、Cline 或 Zed,且需要本地脱敏而非云端 DLP 服务的开发者。
- 运行要求
- 需要本地 Node.js 运行环境;通过 npx @privacyscrubber/mcp-server 或 npm 安装。可选环境变量 PRIVACYSCRUBBER_KEY 用于解锁 PRO 或 TEAMS 检测配置。仅限桌面端,无远程端点。
安装
在 SourceWeft 中
- 打开 控制台中的 Privacyscrubber Mcp,将其添加到工作区。
- 为需要使用其工具的对话启用该服务。
Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。
其他 MCP 客户端
参照 仓库 中的启动说明。
README
@privacyscrubber/mcp-server
[NPM Version] [NPM Downloads] [PyPI Version] [PyPI Downloads] [NPM SDK] [Presidio Alternative] [Zero Dependencies] [License: MIT] [DOI] [OSF DOI] [SSRN] [IETF Specification] [ZTDS Verified] [smithery badge] [Cursor Directory] [Glama.ai] [TensorBlock MCP Index] [There's An AI For That] [Security: 100% Local] [Parity: 100% Core Match] [Patent Pending] [Developer SDK] [TEAMS Plan] [GitHub Stars]
CISO-Approved Zero-Trust PII & Secrets Redaction MCP Server for Cursor, Windsurf, and Claude Desktop. Locally scrubs PII, secrets, credentials, and custom regex rules from files and text contexts before they reach remote LLM providers to prevent API leaks and ensure HIPAA/SOC 2 compliance at the developer endpoint.
Support Zero-Trust Open Source: If PrivacyScrubber protects your API keys, source code, and developer credentials from model leaks, please Star this repository on GitHub or execute
gh repo star moxno/privacyscrubber-mcp.
Direct Commercial Licensing & Production Infrastructure:
Looking to automate zero-trust PII redaction inside backend microservices, ETL pipelines, or LangChain/LlamaIndex agents?
- Developer SDK ($299/mo flat or $2,990/yr): Unlimited internal backend nodes, zero network egress, <1ms in-memory latency. Subscribe to Developer SDK | Technical Specs
- TEAMS ($99/mo flat): Unlimited team seats across your entire domain with cryptographic P2P session handoff. Deploy TEAMS Plan
- PRO ($15/mo or $110 Lifetime): Single-seat unlimited throughput across all 30 vertical profiles. Get PRO License
🔒 Zero-Trust Data Flow
All sensitive parameters, identifiers, and variables are intercepted locally inside your machine's RAM. They are replaced by tokens (e.g. [EMAIL_1]) before being sent to the AI. Once the AI responds, the tokens are safely swapped back to original values in your local context.
🚀 Installation
1. 1-Click Universal Auto-Installer (Recommended)
Automatically detects installed AI IDEs on your machine and safely configures PrivacyScrubber without corrupting existing tools:
2. Install via Smithery
To automatically configure and run with your preferred client, install using Smithery:
3. Instant Run with NPX
Run the server directly without local installation:
4. Instant Run with UVX (Python / PyPI)
Run the server directly inside Python agent workflows (CrewAI, LangChain, AutoGen, LlamaIndex):
Or via pip:
5. Programmatic Node.js / TypeScript SDK (Lightweight Presidio Alternative)
Need direct, in-memory zero-trust PII sanitization in your backend microservice, Next.js app, or RAG vector pipeline rather than an MCP server? Use our official zero-dependency SDK:
⚡ Why @privacyscrubber/sdk vs Microsoft Presidio?
Microsoft Presidio is the Python standard, but deploying it in a Node.js / TypeScript stack requires running heavy Python microservices, Docker containers, and 500MB+ spaCy NLP models with 35–120ms latency. @privacyscrubber/sdk runs 100% in-process with zero dependencies:
👉 View @privacyscrubber/sdk on NPM | Full documentation, Express middleware, LangChain transforms, and 25 compliance profiles.
🤖 AI Orchestrator Recipes: LangChain, LlamaIndex, CrewAI & AutoGPT
If you are building autonomous agents, RAG vector pipelines, or backend services rather than single-user IDE prompts, use @privacyscrubber/sdk to sanitize data in-memory:
1. LangChain.js (LCEL & RAG Document Ingestion)
2. LlamaIndex.TS & Universal Vector DB Ingestion (Chroma, Pinecone, Qdrant)
Complete runnable recipes are included inside the npm package under
@privacyscrubber/sdk/examples/(or runnpx @privacyscrubber/sdk).
3. CrewAI & Multi-Agent Swarms (Sidecar Mode / Python Interop)
4. AutoGPT / Multi-Turn Autonomous Agents
Enterprise & Production Licensing:
- Self-Serve Developer SDK ($299/mo flat or $2,990/yr): Unlimited internal backend nodes, microservices, and RAG pipelines. Subscribe to Developer SDK | Developer SDK Specs
- PrivacyScrubber TEAMS ($99/mo flat): Unlimited team seats, centralized policy enforcement, encrypted session handoff. Deploy TEAMS Plan
- Enterprise Air-Gapped License: On-premise source code distribution, zero-network custom models. Contact Enterprise
🛡️ Architecture & Security Deep-Dive (Zero-Trust vs Cloud DLP)
When AI IDEs (Cursor, Claude Desktop, Windsurf) connect to model providers, developer credentials, database connection strings, and internal customer PII are at continuous risk of prompt exfiltration. The @privacyscrubber/mcp-server enforces four immutable architectural guarantees:
- Stdio Air-Gapped Transport:
The MCP server communicates exclusively over local standard input/output (
stdio) child processes spawned by your IDE. It opens zero external listening ports and initiates zero remote network requests. - Volatile RAM-Only Token Map:
The mapping table between synthetic tokens (
[AWS_KEY_1],[EMAIL_1]) and raw cleartext is maintained exclusively in ephemeral node memory and is wiped the moment your IDE session closes. - Local ZTDS™ In-Memory Engine vs Cloud Proxy Overhead:
Unlike cloud DLP gateways (Nightfall, Skyflow) that add 200–400ms latency and transmit unencrypted code to third parties,
@privacyscrubber/mcp-serverruns locally in <2ms with zero data egress. - Permanent Standards & Academic Validation:
- IETF Specification: draft-sibiryakov-ztds-protocol-01 — Revision 01 · 2026-09-23 · 13 pages
- CERN / Zenodo Foundation: DOI 10.5281/zenodo.22058770
- Center for Open Science (OSF): DOI 10.17605/OSF.IO/5BYJF
- Patent Pending: U.S. & International Patents Pending (Paris Convention / PCT Priority)
⚙️ Client Integrations
Claude Desktop
Add this to your Claude Desktop config file:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
Cursor
Add to your project's .cursor/mcp.json (workspace) or ~/.cursor/mcp.json (global):
Or via Cursor GUI: Open Settings (Cmd/Ctrl + ,) → Features → MCP → + Add New MCP Tool:
- Name:
privacyscrubber - Type:
command - Command:
npx -y @privacyscrubber/mcp-server
Windsurf (Codeium)
Add to ~/.codeium/windsurf/mcp_config.json:
Or via Windsurf GUI: Open Settings → MCP Settings → add new command server npx -y @privacyscrubber/mcp-server.
Ready-to-copy JSON templates for all supported clients are available in
examples/configs/.
Cline / Roo Code
Add to cline_mcp_settings.json:
Claude Code CLI
Add directly from your terminal:
VS Code Native MCP (.vscode/mcp.json)
For official VS Code Native MCP support, configure your project's .vscode/mcp.json:
Zed IDE (settings.json)
Add to your Zed configuration (~/.config/zed/settings.json or %APPDATA%\Zed\settings.json):
🛠️ Provided Tools & JSON-RPC Specifications
1. sanitize_text
Redacts PII, secrets, API keys, and credentials from a text block and populates the volatile local replacement mapping.
- Arguments:
text(string, required): The raw content or logs to sanitize.profile(string, optional): Gated industry detection profile (e.g., 'General', 'Dev', 'Medical', 'Legal', 'Compliance'). Defaults to 'General'.
- JSON-RPC Call Example:
- Response Example:
2. reveal_text
Detokenizes the AI response back to the original values locally.
- Arguments:
text(string, required): The response from the LLM containing tokenized placeholders.
- JSON-RPC Call Example:
- Response Example:
3. sanitize_file
Reads a local file, extracts text, sanitizes it, and returns the redacted template for LLM analysis.
- Supported Formats: Plain text (source code, logs, CSV, JSON, markdown) and Microsoft Word (
.docx) documents. - Arguments:
filePath(string, required): Absolute file path to read and sanitize.profile(string, optional): The industry detection profile.
4. guard_exec (Command Execution Firewall)
Safely executes terminal commands in an isolated child process, masking stdout/stderr PII, database credentials, and API keys in local RAM before passing them to the AI agent. Includes a CISO audit receipt in stderr.
- Arguments:
command(string, required): The shell command to execute (e.g.cat .env,docker logs web,git diff).cwd(string, optional): Working directory.profile(string, optional): Detection profile (defaults toDev).timeout_ms(number, optional): Timeout in ms (defaults to15000).
5. guard_read_file (Credential-Masking File Reader)
Reads files (.env, configs, source code, database dumps) and tokenizes all passwords, JWTs, and PII in volatile memory, returning safe redacted content for AI reasoning.
- Arguments:
file_path(string, required): Path to file.profile(string, optional): Detection profile (defaults toDev).max_lines(number, optional): Line cap for large files (defaults to500).
6. guard_git_diff (Pre-Commit & Diff Sanitizer)
Inspects staged (--cached) or unstaged repository diffs, redacting any newly introduced secrets or PII in local RAM before AI code review or commit message generation.
- Arguments:
staged(boolean, optional): Iftrue, inspects staged changes (git diff --cached). Defaults tofalse.cwd(string, optional): Working directory.profile(string, optional): Detection profile (defaults toDev).
7. guard_apply_patch (Safe Patch Applicator)
Reverses token placeholders ([API_KEY_1], [SECRET_1]) in AI-generated code or text by looking up the local RAM session map, creating a .bak backup, and writing authentic cleartext directly to disk. The remote LLM never sees real secrets.
- Arguments:
file_path(string, required): Path to target file.content(string, required): Content containing tokens to restore on disk.create_backup(boolean, optional): Backup existing file before write (defaults totrue).
8. create_agent_rules (1-Click Agent Rule & Deterministic Hook Injection)
Automatically scaffolds CISO-grade Zero-Trust directives into .cursorrules, .windsurfrules, CLAUDE.md, .github/copilot-instructions.md, .clinerules, plus deterministic IDE lifecycle hooks in .cursor/hooks.json (beforeReadFile, beforeShellExecution) and .claude/settings.json (PreToolUse).
- Arguments:
agent_types(array, optional):["all"],["cursor"],["windsurf"],["claude_code"],["copilot"],["cline"]. Defaults to["all"].workspace_dir(string, optional): Workspace directory.
9. check_status
Returns a visual dashboard showing your current tier, session request count, active profiles, and upgrade instructions. Use it at any time to check your license status or get setup help.
- Arguments: (none required)
- JSON-RPC Call Example:
- Response Example (Free Tier):
10. generate_procurement_memo (CISO & DPO Procurement Hub)
Generates an institutional business case, regulatory risk breakdown, and procurement memo for CISO, DPO, and Legal sign-off. Computes deterministic ROI versus breach penalties and cloud DLP egress fees.
- Arguments:
targetTier(string, optional): Target plan ("teams"at $99/mo or"sdk"at $299/mo). Defaults to"teams".teamSize(number, optional): Estimated developer / analyst seat count (defaults to10).primaryFramework(string, optional): Core compliance framework ("gdpr","hipaa","soc2", or"pci_dss"). Defaults to"gdpr".
- JSON-RPC Call Example:
- Output: Formatted Markdown enterprise procurement memorandum ready for immediate insertion into internal RFCs, Confluence wikis, or enterprise purchase requisitions.
🛡️ Standalone CLI: ps-guard
PrivacyScrubber bundles ps-guard for Unix pipe, pre-commit, and agentic workflows:
🌐 Browser Extension & Web Client
Looking for real-time protection directly inside your web browser?
- Chrome Extension: Get the PrivacyScrubber Chrome Extension to sanitize prompts directly inside ChatGPT, Claude, and Gemini in real-time.
- Web Sandbox: Use the zero-server browser sanitization tools at PrivacyScrubber Homepage.
📄 License & Commercial Upgrade
By default, the server runs under the Free Tier (15,000 characters per request on the General PII profile and a 5,000-character trial quota per request across all 30 specialized industry profiles). To unlock unlimited throughput across all 30 specialized engineering, medical, legal, and financial PII profiles, as well as team-wide custom rules, you can purchase a commercial license.
Commercial Plan & Feature Comparison
👉 Acquire a Commercial License Key at privacyscrubber.com/pricing
🔐 After Purchase: Activate PRO in Your MCP Client
After purchasing a PRO license at privacyscrubber.com/pricing, you will receive a license key. Add it to your MCP client config as an environment variable: PRIVACYSCRUBBER_KEY.
Claude Desktop
Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
Restart Claude Desktop after saving.
Cursor
- Go to Settings → Features → MCP Servers.
- Find
privacyscrubberand click Edit. - Add the environment variable:
PRIVACYSCRUBBER_KEY=YOUR_LICENSE_KEY_HERE. - Restart Cursor.
Alternatively, export it system-wide so all tools pick it up:
Windsurf
Edit ~/.codeium/windsurf/mcp_config.json:
Verify Activation
After adding the key, ask your AI agent to call check_status:
🔗 Ecosystem & Production Architecture Guides
- 🌐 Web App: https://privacyscrubber.com
- 📦 Node.js / TypeScript SDK: @privacyscrubber/sdk (npm)
- 🧩 Chrome Extension: Chrome Web Store
- 🛡️ RAG & Vector Databases: Sanitizing PII Before Vector DB Ingestion (Pinecone, Chroma, Qdrant)
- 🤖 LangChain & LlamaIndex: In-Memory PII Middleware for AI Agent Pipelines
- ⚡ AWS Comprehend Alternative: In-Memory Redaction Without Egress or Cloud Overhead
📚 Academic Foundations & Regulatory Verification
PrivacyScrubber and the Zero-Trust Data Sanitization (ZTDS) protocol are backed by published scientific, clinical, and legal treatises:
Citing PrivacyScrubber in Research & Audits
📄 License
MIT © Ilya Sibiryakov (BrandMeWeb)
⚖️ Intellectual Property & Patent Disclosures
The Zero-Trust Data Sanitization (ZTDS) architecture, in-memory deterministic tokenization, cryptographic session handoff, and stdio execution methods implemented in this package are proprietary technology of Ilya Sibiryakov (BrandMeWeb) and are protected under Patent Pending status:
- Legal Status: U.S. & International Patents Pending
- Priority Framework: Paris Convention Art. 4 & 35 U.S.C. § 119 Priority (Active 12-Month Window)
- Patent Status: U.S. & International Patents Pending (Priority Locked)
- Official Title: SYSTEM AND METHOD FOR CLIENT-SIDE ZERO-TRUST DATA SANITIZATION AND CRYPTOGRAPHIC SESSION HANDOFF IN ARTIFICIAL INTELLIGENCE WORKFLOWS
- Patent Disclosures Hub: privacyscrubber.com/patents/ (formal verification via counsel NDA).
🌐 Internet Engineering Task Force (IETF) Specification
- Specification Title: The Zero-Trust Data Sanitization (ZTDS) Protocol for Frontier Artificial Intelligence Ingestion
- Document Category: IETF Internet-Draft (Individual Submission)
- IETF Datatracker: https://datatracker.ietf.org/doc/draft-sibiryakov-ztds-protocol/
- Archive Plaintext: https://www.ietf.org/archive/id/draft-sibiryakov-ztds-protocol-01.txt
来源:README.md,提交 63b9fa4
工具
0版本历史
2- v2.2.5最新Sep 27, 2026
- v1.0.2Sep 16, 2026
评分
已满足适用检查项的 40%
该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。
- 近 30 天内可连通25 分
请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。
- 已声明认证方式10 分
请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。
- 已列出工具15 分
请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。
- 描述必需15 分
- 图标10 分
- 文档15 分
- 许可证10 分
请在仓库或注册中心条目中声明许可证。