mcp-files

Files MCP Server

mcp-files gives AI coding agents tools to locate named code blocks, edit specific line ranges, and send native OS notifications. It supports workflows that connect symbol discovery with targeted changes, including work in large files.

Server facts

mcp-files

Project

Author
flesler
License
Not specified

Tech

Runtime / language
Not specified
Transports
stdio
Remote available
No
Authentication
Not specified

Activity

GitHub stars
10
Last commit
Data as of

Tags

  • Claude
  • Code Analysis
  • Cursor
  • files
  • import inspection
  • llm
  • mcp
  • model context protocol
  • notifications
  • symbol search
  • text replacement
  • tools

Overview

Code lookup and line-based editing form the core workflow in mcp-files, a toolkit for AI agents such as Cursor. The read_symbol tool retrieves blocks associated with a symbol name, supporting TypeScript, JavaScript, GraphQL, CSS, and other formats that delimit blocks with braces. An agent can use those results to locate a function, class, or interface before changing its implementation. With insert_text, it can add content at a chosen line or replace a specified range, making line references from code citations usable as editing targets without supplying extensive surrounding text.

The toolkit also includes os_notification for delivering messages through the operating system’s native notification facilities, with an optional title. Beyond agent integration over stdio, the README describes direct command-line access to the tools. Its examples connect symbol lookup with replacing implementations or adding documentation near a declaration. These workflows serve coding assistants that need to inspect named sections and apply localized file changes, while notifications provide a separate way to surface messages.

mcp-files setup notes

  • mcp-files records stdio only; confirm a network transport upstream before planning remote access.
  • mcp-files has no recorded license; confirm reuse terms in its repository.

Related MCP servers