MCP File Surgeon

Example Use Cases

• 1

  Make surgical code edits to specific lines or character ranges and preview changes as unified diffs before applying them

• 2

  Search for and extract specific content or slices from very large files without loading entire files into memory

• 3

  Safe, stateless file management capabilities (read, write, copy, delete, list, get metadata) to avoid session blocking and reduce context/token usage

Description

MCP File Surgeon provides a set of tools for programmatic, surgical file operations targeted at AI agents, including reading/writing files, patching by lines or character positions with unified-diff previews, finding content, slicing large files, and getting file metadata or directory listings. It is designed to be stateless to avoid session-blocking editors and to safely handle very large files without freezing or excessive context usage. The project aims to reduce token costs and enable precise code and document edits without error-prone copy/paste workflows. It is distributed as an open-source npm package and includes development and debugging instructions.