MCP Diff Editor
samihalawa
README
MCP Diff Editor
A powerful MCP-integrated diff editor for modifying files with preview capabilities.
Features
- Edit files through a web interface with real-time diff preview
- Apply changes using unified diff format or complete file replacement
- Create backups automatically before making changes
- Restore from previous backups
- View examples of common diff operations
- Security controls to prevent unauthorized file access
Usage as MCP
The MCP diff editor provides the following methods:
start
Start the diff editor server
stop
Stop the diff editor server
status
Check server status
edit_file
Open the diff editor for a specific file
- Parameters:
file_path
: Path to the file to edit
apply_diff
Apply a diff to a file
- Parameters:
file_path
: Path to the file to modifydiff_content
: Diff content to apply
preview_diff
Preview a diff without applying it
- Parameters:
file_path
: Path to the file to preview changes fordiff_content
: Diff content to preview
Example Usage
const mcp = require('mcp');
const diffEditor = mcp.get('diff_editor');
// Start the server
await diffEditor.start();
// Open the editor for a specific file
const result = await diffEditor.edit_file({
file_path: '/path/to/your/file.txt'
});
// Get the URL to access the editor
console.log(result.url);
// Apply a diff to a file
await diffEditor.apply_diff({
file_path: '/path/to/your/file.txt',
diff_content: `@@ -5,7 +5,7 @@
<title>Sample Page</title>
</head>
<body>
- <h1>Welcome to our website</h1>
+ <h1>Welcome to our awesome website!</h1>
<p>Thanks for visiting us.</p>
</body>
</html>`
});
Environment Variables
PORT
: HTTP port (default: 3009)MCP_FILE_DIR
: Directory to use as base for file operations (default: current directory)MCP_ALLOW_ANY_PATH
: Set to 'true' to allow accessing files outside the working directory
Installation
This module is intended to be used as an MCP in the /Users/samihalawa/Documents/MCP
directory and should be automatically available in the MCP interface after installation.
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
MCP Package Docs Server
Facilitates LLMs to efficiently access and fetch structured documentation for packages in Go, Python, and NPM, enhancing software development with multi-language support and performance optimization.
Claude Code MCP
An implementation of Claude Code as a Model Context Protocol server that enables using Claude's software engineering capabilities (code generation, editing, reviewing, and file operations) through the standardized MCP interface.
@kazuph/mcp-taskmanager
Model Context Protocol server for Task Management. This allows Claude Desktop (or any MCP client) to manage and execute tasks in a queue-based system.
Linear MCP Server
Enables interaction with Linear's API for managing issues, teams, and projects programmatically through the Model Context Protocol.
mermaid-mcp-server
A Model Context Protocol (MCP) server that converts Mermaid diagrams to PNG images.
Jira-Context-MCP
MCP server to provide Jira Tickets information to AI coding agents like Cursor

Linear MCP Server
A Model Context Protocol server that integrates with Linear's issue tracking system, allowing LLMs to create, update, search, and comment on Linear issues through natural language interactions.

Sequential Thinking MCP Server
This server facilitates structured problem-solving by breaking down complex issues into sequential steps, supporting revisions, and enabling multiple solution paths through full MCP integration.