A secure MCP filesystem server with Stdio and Web UI modes.
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":"fs-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.
# fs-mcp :open_file_folder: **Universal, Provider-Agnostic Filesystem MCP Server** *Works with Claude, Gemini, GPT — zero configuration required.* [](https://pypi.org/project/fs-mcp/) [](https://github.com/luutuankiet/fs-mcp/actions/workflows/test-deps.yaml) [](https://www.python.org/downloads/) --- https://github.com/user-attachments/assets/132acdd9-014c-4ba0-845a-7db74644e655 ## Why This Exists MCP (Model Context Protocol) is incredible, but connecting AI agents to filesystems hits real-world walls: | Problem | fs-mcp Solution | |---------|-----------------| | **Container Gap** — Stdio doesn't work across Docker boundaries | HTTP server by default — connect from anywhere | | **Token Waste** — Agents dump entire files to find one function | Smart `grep -> read` pattern with section hints | | **Schema Hell** — Gemini silently corrupts nested object schemas | Auto-transforms schemas at runtime — just works | | **Blind Overwrites** — One hallucination wipes your `main.py` | Human-in-the-loop review with VS Code diff | | **Verbose Output** — build/test/git output wastes context window | RTK compresses tool output 30-70% automatically | **fs-mcp** is a Python-based server built on `fastmcp` that treats **efficiency**, **safety**, and **universal compatibility** as first-class citizens. --- ## Quick Start ### Run Instantly ```bash # One command — launches Web UI (8123) + HTTP Server (8124) uvx fs-mcp . ``` ### Selective Launch ```bash # HTTP only (headless / Docker / CI) fs-mcp --no-ui . # UI only (local testing) fs-mcp --no-http . ``` ### Docker ```bash # In your Dockerfile or entrypoint uvx fs-mcp --no-ui --http-host 0.0.0.0 --http-port 8124 /app ``` --- ## The Toolbox ### Discovery & Reading | Tool | Purpose | |------|---------| | `grep_content` | Rege…
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.