Files MCP Server

@flesler

代码仓库

基本信息

分类

文件与存储

传输方式

stdio

作者

flesler

提交者

Ariel Flesler

关于 Files MCP Server

⚡ Surgical Code Editing: Superhuman Precision

#mcp #cursor #claude #model-context-protocol #code-analysis#symbol-search#text-replacement#import-inspection#notifications #llm #tools #files

Files MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

Files MCP Server 工具

Find and extract symbol block by name from files, supports a lot of file formats (like TS, JS, GraphQL, CSS and most that use braces for blocks). Uses streaming with concurrency control for better performance

Insert or replace text at precise line ranges in files - Ideal for direct line-number operations (from code citations like 12:15:file.ts) and large files where context-heavy editing is inefficient. - TIP: Combine with read_symbol (must use optimize: false!) to edit any symbol anywhere without knowing its file or line range!

Send OS notifications using native notification systems.

概览

What is Files?

Files is an MCP server that provides file-oriented tools for AI agents like Cursor. It supports reading symbols from code, performing search-and-replace, inserting text at precise line ranges, inspecting JavaScript/TypeScript modules, and sending OS notifications.

How to use Files?

Install and run via npx mcp-files or as a Docker container. Configure the MCP client (e.g., Cursor or Claude Desktop) with a JSON entry pointing to npx -y mcp-files. Alternatively use HTTP transport by setting the environment variable TRANSPORT=http. Tools can also be invoked directly from the command line, e.g., mcp-files read_symbol "MySymbol" src/file.ts.

Key features of Files

Find code symbols anywhere in the codebase with read_symbol.
Perform intelligent search-and-replace with search_replace.
Insert or replace text at exact line ranges with insert_text.
Inspect JavaScript/TypeScript modules and their properties.
Send native OS notifications with os_notification.
Supports both stdio and HTTP transport modes.
Requires Node.js 20 or higher.

Use cases of Files

Locate and modify a specific function across large codebases.
Replace deprecated implementations with surgical precision.
Insert documentation or comments at exact code locations.
Import and inspect module exports for dependency analysis.

常见问题

What runtime does Files require?

Node.js version 20 or higher is required.

How do I clear the npx cache if tools don't load?

Run `npx clear-npx-cache` followed by `npx mcp-files` to resolve `ERR_MODULE_NOT_FOUND` errors.

Can Files be used over HTTP?

Yes, set the environment variable `TRANSPORT=http` and optionally `PORT` (default 4657) to expose an HTTP server.

Which transports does Files support?

It supports stdio (default) and HTTP transport modes.

How do I see all available tools and parameters?

The README lists tools such as `read_symbol`, `import_symbol`, `search_replace`, `insert_text`, and `os_notification` with their parameters. Running `mcp-files --help` also shows usage.

文件与存储分类下的更多 MCP 服务器

Bulk Filesystem Operations MCP Server

strawgate

MCP Server for reading many files at the same time

MCP Filesystem Server

mark3labs

Go server implementing Model Context Protocol (MCP) for filesystem operations.

664

pdfAssistant MCP Server

pdfassistant-ai

Official MCP server for pdfAssistant. Connect Claude, ChatGPT, or any MCP client to perform professional PDF processing like OCR, permanent redactions, secure encryption, format conversions, and 40+ advanced operations p

S3 MCP Server

samuraikun

MCP server to integrate AWS S3 and LLM

PDF Tools MCP

danielkennedy1