Hashline Edit

Provides line-addressed file edits with hashline integrity checks for safe, atomic modifications via MCP clients.

typescript

0

GitHub Stars

typescript

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "submersible-mcp-hashline-edit-server": {
      "command": "bunx",
      "args": [
        "mcp-hashline-edit-server"
      ]
    }
  }
}

You can use the hashline-based MCP server to perform line-addressed edits on files with content hashes for integrity verification. This enables precise edits while protecting against unintended changes, making it ideal for automated code modifications and AI-assisted workflows.

How to use

To enable editing through MCP clients, run the server locally and communicate via standard input/output. The server accepts hashline-verified editing requests and returns updated content while ensuring edits apply only if the file state matches the last read. You can read a file with hashline prefixes, perform atomic, hash-verified edits, and write or search files as part of your workflow.

How to install

Prerequisites you need before installing this MCP server are a Bun runtime, and ripgrep (rg) available on your system PATH.

Install the MCP server using npm or Bun:
```bash
npm install mcp-hashline-edit-server

or

bun add mcp-hashline-edit-server

Additional setup and running the server

From source, you can build and run the server directly. The following steps clone the repository, install dependencies, and start the server.

git clone https://github.com/Submerisble/mcp-hashline-edit-server.git
cd mcp-hashline-edit-server
bun install
bun run src/index.ts

Run with an MCP client

The server exposes a standard input/output interface. Start it with the following command and connect an MCP client to its stdio stream.

bunx mcp-hashline-edit-server

Available tools

read_file

Read a file and output lines with hashline prefixes to track content integrity.

edit_file

Apply edits using hash-verified references or fuzzy replacements. Supports set_line, replace_lines, insert_after, and replace operations. Edits are validated against the last read state and applied atomically.

write_file

Create or overwrite a file with specified content.

grep

Search files using hashline-prefixed results and ripgrep with enhanced context and filtering.