Reusable Privacy MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Reusable Privacy MCP Server search my local notes for password reset steps"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Reusable Privacy MCP Server
English | Português (Brasil)
A zero-data-leakage, privacy-first Model Context Protocol (MCP) server designed for any local document workspace.
Features
🔒 Zero External Data Exposure: Inverted keyword indexing and full-text searching run 100% offline.
🛡️ Automated PII & Secret Redaction: Automatically strips CPFs, CNPJs, Emails, Phone numbers, Passwords, and Secrets before sending snippets to LLMs.
🚫 Path Access Control: Blacklists sensitive subfolders (e.g.
Financeiro,Recursos Humanos,.git).⚡ Just-In-Time (JIT) Snippets: Line-bounded snippet retrieval prevents context stuffing.
⚙️ Config-Driven: Customize security rules per workspace using a local
.mcp-privacy.ymlfile.
Related MCP server: Synorive
Getting Started
Install dependencies:
npm installBuild the Node.js project:
npm run build(Optional) Build as a standalone
.exe(No Node.js required on target machine):npm run build:exe # or: bun run build:exeThis compiles
privacy-mcp.exe. When launched withoutMCP_PROJECT_ROOT, it automatically targets the folder it is placed in or executed from (process.cwd()).
How to Register in Client Hosts (Claude Desktop / Cursor / Antigravity)
Option A: Using Node.js
Add this entry to your claude_desktop_config.json or MCP configuration:
{
"mcpServers": {
"workspace-docs": {
"command": "node",
"args": ["/path/to/privacy-mcp-server/dist/index.js"],
"env": {
"MCP_PROJECT_ROOT": "/path/to/your/documents"
}
}
}
}Option B: Using Standalone Executable (privacy-mcp.exe)
{
"mcpServers": {
"workspace-docs": {
"command": "/path/to/privacy-mcp-server/privacy-mcp.exe",
"env": {
"MCP_PROJECT_ROOT": "/path/to/your/documents"
}
}
}
}Tip: If MCP_PROJECT_ROOT is omitted in Option B, privacy-mcp.exe automatically protects and indexes whichever directory it is launched from.
Multi-MCP & Multi-Workspace Architecture
To scale this tool across multiple folders or combine it with other MCP tools:
MCP Gateway / Meta-MCP Router: Run a proxy server that aggregates
privacy-mcpwith other MCP servers (Git, SQLite, Web Search) into a single client entry point with tool namespacing (privacy_search,git_diff).Multi-Workspace Support: Configured via
mcp-workspaces.ymlto index multiple project roots under a single server instance usinglist_workspacesandsearch_all_workspaces.Modular Plugin Architecture: Embed multiple tools (privacy engine, git inspector, tabular data parser) directly into the single
.exebinary, enabled per workspace.Auto-Discovery Launcher: A lightweight system tray utility (
mcp-tray.exe) that watches folders for.mcp-privacy.ymland auto-registers them into Claude/Cursor configs.
For detailed design blueprints on these patterns, see docs/MULTI_MCP_ARCHITECTURE.md.
Workspace Configuration (.mcp-privacy.yml)
Place a .mcp-privacy.yml file in any workspace root directory:
name: "My Project Knowledge Base"
security:
restricted_directories:
- "Financeiro"
- "Recursos Humanos"
- "Certificado Digital"
- ".git"
- "node_modules"
allowed_extensions:
- ".md"
- ".json"
- ".txt"
- ".csv"
max_snippet_lines: 50
redaction:
enable_default_pii: trueAvailable Tools
3 toolslist_structureC
Safely lists allowed subdirectories and document files in the workspace.
Inputs: subpath.
read_snippetB
Retrieves a line-bounded, sanitized snippet from an allowed file.
Inputs: relativePath (required), lineCount, startLine.
search_docsB
Searches documents locally using full-text keywords. Returns sanitized matching lines.
Inputs: query (required), maxResults.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool targets a distinct operation: listing structure, searching content, and reading a bounded snippet. There is no overlap in purpose, making selection unambiguous.
All tools follow a consistent snake_case verb_noun pattern (list_structure, search_docs, read_snippet). The naming is predictable and easy to parse.
Three tools is within the typical well-scoped range (3–15) and each earns its place for a focused read-only document access server. No tool feels redundant or missing.
The surface covers listing, searching, and reading snippets, which is a complete read-only lifecycle for a privacy-focused document server. Minor gaps exist (e.g., no metadata or pagination tool), but agents can work around them.
Maintenance
Related MCP Connectors
Securely search and manage workspace context files for AI agents and teams.
Read and search folders on your own computer with explicit consent. Files are never uploaded.
Private, multimodal knowledge store for agents: hybrid search with cited, provenance-backed results.
Multi-engine search for AI agents. Trust scoring, local corpus, MCP-native. Self-hostable, BYOK.
Related MCP Servers
- AlicenseAqualityAmaintenancePrivacy-first local document search using semantic search. Runs entirely on your machine with no cloud services, supporting PDF, DOCX, TXT, and Markdown files.95,381 npm430MIT
- AlicenseNot gradedqualityCmaintenanceEnables private, offline semantic search across local files (documents, images, videos) using OCR and vector search, and optionally performs web research with cited sources.AGPL 3.0
- AlicenseAqualityBmaintenanceEnables local AI agents to perform hybrid search (BM25 + vector) over privately indexed local files, including notes, PDFs, DOCX, source code, and OCR'd images. All indexing and retrieval stay on the machine with read-only, whitelist-scoped access.3MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI coding agents to perform private, local code search that returns only the most relevant code chunks, reducing token use and setup while keeping repositories on the user's machine.517 npmMIT