
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 分
請在儲存庫或註冊中心條目中宣告授權條款。