File Edit Check

This MCP Server enforces pre-read checks before any file edits, ensuring you read a file prior to writing or applying diffs and providing detailed guidance for commits. It prevents blind modifications and helps maintain a clear, auditable history of changes.

How to use

Use this server alongside your MCP client to manage file edits safely. Before you write to a file, you must perform a read operation to mark the file as read. You can then write to the file or apply diffs only after it has been read. This flow prevents blind changes and encourages explicit visibility into what you modify.

Available actions include reading a file to flag it as read, writing to a file only if it has been read, and applying diffs with the same pre-read requirement. When you commit, provide a detailed commit message that clearly documents what changed and why. You can list the tools registered in this server to see what operations are available.

How to install

Prerequisites you need before installation include Node.js and npm. You will clone or obtain the MCP server source, install dependencies, and build the project.

Run these commands in order to install and build the server:

npm install
npm run build

Configuration and usage notes

Add the server to your MCP settings with an explicit stdio configuration. The server runs locally via Node and points to the built index file.

{
  "mcpServers": {
    "file-edit-check": {
      "command": "node",
      "args": ["/path/to/file-edit-check-server/build/index.js"],
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

Available tools

checked_read_file

Reads a file and marks it as read for future edits, enabling subsequent write or diff operations.

checked_write_to_file

Writes to a file, requiring it to have been read first if the file exists to prevent blind writes.

checked_apply_diff

Applies a diff to a file, requiring the file to have been read first to ensure visibility of changes.

list_my_tools

Lists all tools registered in this MCP server for discovery and usage.