MCP.so
ログイン
F

Files

@flesler

リポジトリ

Files について

⚡ Surgical Code Editing: Superhuman Precision

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

基本情報

カテゴリ

ファイルとストレージ

トランスポート

stdio

公開者

flesler

投稿者

Ariel Flesler

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

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

ツール

4

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

Search and replace with intelligent whitespace handling and automation-friendly multiple match resolution. Tries exact match first, falls back to flexible whitespace matching only when no matches found.

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 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.

FAQ from Files

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.

コメント

「ファイルとストレージ」の他のコンテンツ

Google Drive server

isaacphi

Model Context Protocol (MCP) Server for reading from Google Drive and editing Google Sheets

283

MCP docx server

h4ck4life

MCP server to manipulate DOCX file

7

Storacha MCP Storage Server

storacha

Storacha MCP storage server - self-sovereign data for your AI applications.

13

PDF Reader MCP Server (@sylphlab/pdf-reader-mcp)

sylphlab

📄 The PDF intelligence layer for AI agents — Agent Document Twin, evidence-first extraction, visual crops, OCR provenance, trust reports, and benchmark-gated releases. MCP server for Claude, Cursor, VS Code, and any MCP client.

810

Mcp Directory

chatmcp

directory for Awesome MCP Servers

2.0K