MCP server that gives AI clients direct access to your local filesystem — save, find, and organize files using natural language
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"ai-vault-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# Vault — MCP File Server An MCP (Model Context Protocol) server that gives any AI client — Claude Desktop, Claude Code, ChatGPT, etc. — direct access to your local filesystem. Save AI-generated content, copy files between folders, download from URLs, and organize your machine using natural language. ## What makes it different Most MCP file tools require you to know and type exact paths. Vault's `find_folder` tool lets you say *"save this to my distributed systems folder"* and Claude finds the right path itself — no copy-paste required. --- ## Quickstart ### 1. Install ```bash # Zero-install (recommended) — runs directly from PyPI uvx ai-vault-mcp # Or install permanently pip install ai-vault-mcp ``` ### 2. Add to your MCP client **Claude Desktop** (`~/Library/Application Support/Claude/claude_desktop_config.json` on Mac): ```json { "mcpServers": { "vault": { "command": "uvx", "args": ["ai-vault-mcp"] } } } ``` **Claude Code:** ```bash claude mcp add vault -- uvx ai-vault-mcp ``` **HTTP mode** (for remote clients or Docker): ```bash uvx ai-vault-mcp --transport http --host 0.0.0.0 --port 8000 ``` ### 3. First-run setup The first time you ask Claude to do anything with files, it'll say: > *"Where would you like to save your files? You can point me to an existing folder (e.g. ~/Documents) or I can create a fresh ~/Documents/Vault folder just for AI-generated files."* Answer in plain English. Claude calls `configure` under the hood, saves your choice to `~/.ai-vault-mcp/config.json`, and never asks again. --- ## Tool reference | Tool | What it does | |---|---| | `configure` | First-run setup — sets allowed roots and default save location | | `find_folder` | Find a folder by name without knowing the exact path | | `save_content` | Save text, markdown, or code to a file | | `save_binary` | Save base64-encoded binary content (images, zips) | | `download_file` | Download any URL to a local folder | | `copy_file` | Copy a file fr…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.