MCP File Editor Server
The MCP File Editor Server is a comprehensive tool for advanced file operations, enabling reading, writing, searching, and editing of files and directories with robust error handling and comprehensive testing.
File Reading: Read entire files or specific line ranges with optional line number prefixes
Text Replacement: Replace content using regex patterns with support for single or multiple occurrences
Content Management: Delete content between specific lines, insert content at specific positions (before/after lines or at end), and replace entire line blocks
Advanced Multi-Line Editing: Perform multiple line replacements in a single operation with automatic line number adjustment
File & Directory Searching: Search for regex patterns within individual files or across directories, with context lines and include/exclude filters
Directory Operations: List files and subdirectories with size information and recursive support
Quality & Integration: Features robust error handling, path validation, content verification, and 80+ test cases for reliability. Designed for seamless integration with MCP-compatible clients via stdio.
Built on Node.js runtime environment for server execution and JavaScript-based file operations
Distributed and installed via npm package manager, with npm-based dependency management
Implemented in TypeScript providing type-safe file manipulation operations and modern JavaScript features
Uses Vitest testing framework for comprehensive test coverage of all file editing operations
Integrates Zod for schema validation of tool parameters and input validation
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCP File Editor Server search for TODO comments in my project's src directory"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP File Editor Server
A comprehensive Model Context Protocol (MCP) server that provides advanced file operations for reading, writing, searching, and editing files. This server offers 10 powerful tools for file manipulation with robust error handling and comprehensive test coverage.
Features
Core Tools
read_file- Read file contents with flexible optionsFull file reading or specific line ranges
Optional line number prefixes
Support for partial file reading
replace_in_file- Regex-based string replacementSingle or multiple occurrence replacement
Complex regex pattern support
Safe replacement with occurrence limits
delete_from_file- Remove content between line numbersLine content verification for safety
Single or multi-line deletion
Precise line range targeting
insert_into_file- Insert content at specific positionsBefore/after line placement
End-of-file appending
Line content verification
replace_lines_in_file- Replace content between linesMulti-line content replacement
Line content verification
Flexible content insertion
multireplace_lines_in_file- Multiple line replacements with automatic adjustmentPerform multiple edits in a single operation
Automatic line number adjustment after each edit
Detailed success/failure reporting for each edit
Handles complex line shifting scenarios
search_file- Search within individual filesRegex pattern matching
Context lines (before/after)
Detailed match reporting
list_files- Directory content listingFile and directory enumeration
File size information
Recursive directory support
search_directory- Search across multiple filesDirectory-wide regex search
Include/exclude pattern filtering
Recursive subdirectory searching
create_file- Create new files with automatic directory creation
Safe file creation with overwrite protection
Automatic directory structure creation
Comprehensive error handling for file system operations
Key Features
Robust Error Handling: User-friendly error messages with actionable guidance
Path Validation: Absolute path enforcement with helpful error messages
Content Verification: Line content verification to prevent accidental edits
Comprehensive Testing: 80 test cases covering all functionality
TypeScript Implementation: Full type safety and modern JavaScript features
FastMCP Framework: Built on the FastMCP library for optimal performance
Related MCP server: File System MCP Server
Installation
Prerequisites
Node.js 16.x or later
npm or yarn package manager
Install Dependencies
npm installBuild the Project
npm run buildUsage
Cursor-compatible MCP server config
"mcpServers": {
"file-edit": {
"command": "npx",
"args": ["mcp-file-editor@latest"]
}
}Starting the Server
node build/index.jsThe server will start and listen for MCP client connections via stdio transport.
MCP Client Integration
This server is designed to work with MCP-compatible clients. The server communicates via stdio and supports the following MCP tools:
Example Tool Usage
// Read a file
const result = await client.callTool({
name: 'read_file',
arguments: {
file_path: '/absolute/path/to/file.txt',
show_line_numbers: true,
start_line: 1,
end_line: 10
}
});
// Search for patterns
const searchResult = await client.callTool({
name: 'search_directory',
arguments: {
directory_path: '/path/to/search',
regexp: 'TODO|FIXME',
recursive: true
}
});
// Multiple line replacements with automatic adjustment
const multiEditResult = await client.callTool({
name: 'multireplace_lines_in_file',
arguments: {
file_path: '/path/to/file.txt',
edits: [
{
line_start: 10,
line_end: 15,
line_start_contents: 'Line 10: Tenth line',
contents: 'REPLACED LINES 10-15\nWith new content'
},
{
line_start: 25,
line_end: 30,
line_start_contents: 'Line 25: Twenty-fifth line',
contents: 'REPLACED LINES 25-30\nWith different content'
}
]
}
});
// Create a new file
const createResult = await client.callTool({
name: 'create_file',
arguments: {
file_path: '/absolute/path/to/new-file.txt',
contents: 'This is the content of the new file.\nIt can span multiple lines.'
}
});Testing
Run the comprehensive test suite:
npm testThe test suite includes:
80 total tests across 5 test files
Unit tests for all 10 tools
Error handling validation
Edge case coverage
Integration testing with MCP client
Test Coverage
read-file.test.ts- 16 tests for file reading operationsediting-tools.test.ts- 26 tests for file modification tools (including multireplace_lines_in_file)search-tools.test.ts- 22 tests for search and directory operationsutils.test.ts- 16 tests for utility functionscreate_file.test.ts- 7 tests for file creation operations
API Reference
Tool Parameters
read_file
file_path(string, required): Absolute path to the fileshow_line_numbers(boolean, optional): Prefix lines with numbersstart_line(number, optional): Starting line number (1-based)end_line(number, optional): Ending line number (1-based)full(boolean, optional): Read entire file (mutually exclusive with line ranges)
replace_in_file
file_path(string, required): Absolute path to the fileregex_source(string, required): Regular expression patterntarget(string, required): Replacement stringmultiple(boolean, optional): Allow multiple replacements
delete_from_file
file_path(string, required): Absolute path to the fileline_start(number, required): Starting line numberline_end(number, required): Ending line numberline_start_contents(string, required): Expected content of starting line
insert_into_file
file_path(string, required): Absolute path to the fileline_number(number, required): Target line number (0 for end)line_contents(string, required): Expected content of target linewhere(enum, required): 'before' or 'after'contents(string, required): Content to insert
replace_lines_in_file
file_path(string, required): Absolute path to the fileline_start(number, required): Starting line numberline_end(number, required): Ending line numberline_start_contents(string, required): Expected content of starting linecontents(string, required): Replacement content
multireplace_lines_in_file
file_path(string, required): Absolute path to the fileedits(array, required): Array of edit operationsline_start(number, required): Starting line number (1-based)line_end(number, required): Ending line number (1-based)line_start_contents(string, required): Expected content of starting linecontents(string, required): New content to replace the lines with
search_file
file_path(string, required): Absolute path to the fileregexp(string, required): Regular expression patternlines_before(number, optional): Context lines before matcheslines_after(number, optional): Context lines after matches
list_files
directory_path(string, required): Absolute path to the directory
search_directory
directory_path(string, required): Absolute path to the directoryregexp(string, required): Regular expression patternrecursive(boolean, optional): Search subdirectorieslines_before(number, optional): Context lines before matcheslines_after(number, optional): Context lines after matchesinclude(string, optional): File pattern to includeexclude(string, optional): File/directory pattern to exclude
create_file
file_path(string, required): Absolute path to the file to be createdcontents(string, required): Content to write into the new file
Error Handling
The server provides detailed error messages for common issues:
Path validation: Clear messages for relative paths and non-existent files
Content verification: Helpful guidance when line content doesn't match
File operations: Descriptive errors for read/write failures
Parameter validation: Specific guidance for invalid parameters
Contributing
Fork the repository
Create a feature branch
Add tests for new functionality
Ensure all tests pass
Submit a pull request
License
This project is licensed under the MIT License. See LICENSE file for details.
Version History
v1.1.0 – Added
create_filetool for creating files with automatic directory creation and safe‑overwrite protection.
Architecture
The server is built with:
TypeScript for type safety and modern JavaScript features
FastMCP framework for MCP protocol implementation
Zod for schema validation
Vitest for comprehensive testing
fs-extra for enhanced file system operations
The architecture follows clean separation of concerns with:
Main server implementation in
src/index.tsUtility functions in
src/utils.tsComprehensive test suite with proper MCP client integration
Modular tool implementations with consistent error handling
Available Tools
8 toolsdelete_from_fileC
Delete content from a file between specified line numbers.
Inputs: file_path (required), line_end (required), line_start (required), line_start_contents (required).
insert_into_fileB
Insert content into a file at a specific line position.
Inputs: contents (required), file_path (required), line_contents (required), line_number (required), +1 more.
list_filesC
List all files and subdirectories in a given directory.
Inputs: directory_path (required).
read_fileA
Read the contents of a file. You can read the entire file or specific line ranges.
Inputs: file_path (required), end_line, full, show_line_numbers, +1 more.
replace_in_fileB
Replace all occurrences of a regex pattern with a target string in a file.
Inputs: file_path (required), regex_source (required), target (required), multiple.
replace_lines_in_fileC
Replace content between specific line numbers in a file.
Inputs: contents (required), file_path (required), line_end (required), line_start (required), +1 more.
search_directoryC
Search for regex patterns across all files in a directory.
Inputs: directory_path (required), regexp (required), exclude, include, +3 more.
search_fileB
Search for regex patterns in a file and show matching lines with context.
Inputs: file_path (required), regexp (required), lines_after, lines_before.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
Each tool has a clearly distinct purpose with no ambiguity. For example, 'delete_from_file' removes content between lines, 'insert_into_file' adds content at a line, 'replace_in_file' handles regex-based replacements, and 'replace_lines_in_file' targets specific line ranges, making them easily distinguishable. The search tools ('search_directory' vs. 'search_file') also serve different scopes without overlap.
All tool names follow a consistent verb_noun pattern with snake_case, such as 'delete_from_file', 'insert_into_file', and 'search_directory'. This uniformity makes the tool set predictable and easy to understand, with no deviations in naming conventions across the eight tools.
With 8 tools, the server is well-scoped for file editing operations, covering essential actions like reading, writing, deleting, inserting, replacing, and searching. Each tool earns its place by addressing specific needs in file manipulation, avoiding both bloat and insufficiency for the domain.
The tool set provides complete coverage for file editing, including CRUD-like operations (read, insert, delete, replace) and search functionalities at both file and directory levels. There are no obvious gaps, as all core workflows for editing and managing files are supported without dead ends.
Maintenance
Related MCP Connectors
Manage files and folders directly from your workspace. Read and write files, list directories, cre…
Safe folder access for ChatGPT and Claude: read, write and search files, risky tools opt-in.
File tools for your AI chat: PDF tables to Excel, merge PDFs, images to PDF, fill PDF forms.
Find, read and reorganize files across Google Drive, OneDrive, SharePoint and Dropbox, with undo.
Related MCP Servers
- FlicenseAqualityDmaintenanceEnables secure filesystem operations with directory sandboxing and optional read-only mode. Supports file reading/writing, directory management, file searching, and text operations while restricting access to specified directories.12-
- FlicenseNot gradedqualityDmaintenanceEnables safe file system operations including reading, writing, updating, and deleting files with built-in security safeguards, automatic backups, and comprehensive error handling. Provides directory listing, file metadata extraction, and protects against operations on system-critical paths.-
- AlicenseNot gradedqualityCmaintenanceEnables secure local filesystem operations and interactive terminal sessions for AI assistants. Provides 12 tools for file management, directory operations, code searching, and running interactive REPLs with security protections.34 npmMIT
- FlicenseNot gradedqualityNot gradedmaintenanceEnables comprehensive filesystem operations including reading/writing files, directory management, file searching, editing with diff preview, compression, hashing, and merging with dynamic directory access control.1,196,240 npm-