{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_9qr378xu8tcd","handle":"fs-mcp","url":"https://wellknown.network/agents/fs-mcp","links":{"self":"https://wellknown.network/agents/fs-mcp/record.json","html":"https://wellknown.network/agents/fs-mcp","markdown":"https://wellknown.network/agents/fs-mcp/record.md","api":"https://wellknown.network/api/v1/agents/fs-mcp","status":"https://wellknown.network/api/v1/agents/fs-mcp/status","claim":"https://wellknown.network/agents/fs-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/fs-mcp/claim.json","badge":"https://wellknown.network/agents/fs-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/fs-mcp/history","tools":"https://wellknown.network/api/v1/agents/fs-mcp/tools"},"ard":{"identifier":"urn:air::server:fs-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"fs-mcp","summary":"A secure MCP filesystem server with Stdio and Web UI modes.","description":"# fs-mcp :open_file_folder:\n\n**Universal, Provider-Agnostic Filesystem MCP Server**\n\n*Works with Claude, Gemini, GPT — zero configuration required.*\n\n[![PyPI](https://img.shields.io/pypi/v/fs-mcp)](https://pypi.org/project/fs-mcp/)\n[![CI](https://github.com/luutuankiet/fs-mcp/actions/workflows/test-deps.yaml/badge.svg)](https://github.com/luutuankiet/fs-mcp/actions/workflows/test-deps.yaml)\n[![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue)](https://www.python.org/downloads/)\n\n---\n\nhttps://github.com/user-attachments/assets/132acdd9-014c-4ba0-845a-7db74644e655\n\n## Why This Exists\n\nMCP (Model Context Protocol) is incredible, but connecting AI agents to filesystems hits real-world walls:\n\n| Problem | fs-mcp Solution |\n|---------|-----------------|\n| **Container Gap** — Stdio doesn't work across Docker boundaries | HTTP server by default — connect from anywhere |\n| **Token Waste** — Agents dump entire files to find one function | Smart `grep -> read` pattern with section hints |\n| **Schema Hell** — Gemini silently corrupts nested object schemas | Auto-transforms schemas at runtime — just works |\n| **Blind Overwrites** — One hallucination wipes your `main.py` | Human-in-the-loop review with VS Code diff |\n| **Verbose Output** — build/test/git output wastes context window | RTK compresses tool output 30-70% automatically |\n\n**fs-mcp** is a Python-based server built on `fastmcp` that treats **efficiency**, **safety**, and **universal compatibility** as first-class citizens.\n\n---\n\n## Quick Start\n\n### Run Instantly\n\n```bash\n# One command — launches Web UI (8123) + HTTP Server (8124)\nuvx fs-mcp .\n```\n\n### Selective Launch\n\n```bash\n# HTTP only (headless / Docker / CI)\nfs-mcp --no-ui .\n\n# UI only (local testing)\nfs-mcp --no-http .\n```\n\n### Docker\n\n```bash\n# In your Dockerfile or entrypoint\nuvx fs-mcp --no-ui --http-host 0.0.0.0 --http-port 8124 /app\n```\n\n---\n\n## The Toolbox\n\n### Discovery & Reading\n\n| Tool | Purpose |\n|------|---------|\n| `grep_content` | Rege…","publisher":null,"homepage":null,"repository":null,"version":"1.47.3","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:fs-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"dev.filesystem","name":"Filesystem","confidence":1,"provenance":"derived"},{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"}],"categories":["dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"fs-mcp","registry":"pypi","observedAt":"2026-09-15T15:24:29.456Z","publishedAt":"2026-04-18T07:19:54.965385Z","latestVersion":"1.47.3"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"fs-mcp","url":"https://pypi.org/project/fs-mcp/","firstSeenAt":"2026-09-09T16:23:03.152Z","fetchedAt":"2026-09-15T15:22:23.045Z","normalizedAt":"2026-09-15T15:22:23.045Z"}]},"firstSeenAt":"2026-09-09T16:23:03.152Z","updatedAt":"2026-09-15T15:24:29.456Z"}