// readme

Filesystem MCP

Let your AI assistant work with your files, safely.

Read, search, edit, and patch files in the folders you choose.
Secret files stay hidden, and risky changes wait for your OK.

Real sessions with a real model, except the web client demo. The apply? prompt comes from the example gatekeeper client, not the server.

What is this?

Model Context Protocol (MCP) is how AI apps such as Claude, GitHub Copilot in VS Code, and Cursor connect to tools. Filesystem MCP is an MCP server: a small program that runs on your computer and gives the AI 14 tools for working with files. You choose which folders it can use, and everything outside them is off limits.

Once it is connected, you can ask things like:

  • “Find every TODO in this repo and group them by file.”
  • “Rename getUser to fetchUser in all .ts files. Show me the diff first.”
  • “What changed between config.dev.json and config.prod.json?”
  • “Read the last 50 lines of server.log and explain the error.”
  • “Move the old screenshots into archive/2025/.”

Why…