Files MCP Server

Enables agents to quickly find and edit code in a codebase with surgical precision. Find symbols, edit them everywhere.

Local serverstdioMIT

What is the Files MCP Server?

Files is an MCP project maintained in the flesler/mcp-files repository. The maintainer describes its purpose as “Enables agents to quickly find and edit code in a codebase with surgical precision. Find symbols, edit them everywhere”. Read the project documentation for the complete scope.

Installation

The documented npm package is mcp-files. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
read_symbolFind and extract code blocks by symbol name(s) from files. Supports multiple symbols via array
import_symbolImport and inspect JavaScript/TypeScript modules and their properties
search_replaceSearch and replace with intelligent whitespace handling and automation-friendly multiple match resolution
insert_textInsert/replace text at precise line ranges. Perfect for direct line operations from code citations (12:15:file.ts) and surgical edits in large files
os_notificationSend OS notifications using native notification systems

How to install the Files MCP Server

{
  "mcpServers": {
    "mcp-files": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-files"
      ]
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.