Semantic Edit

Provides a Model Context Protocol server for AST-aware code editing across languages.

rust

5

GitHub Stars

rust

Language

6 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": {
    "jbr-semantic-edit-mcp": {
      "command": "/path/to/semantic-edit-mcp/semantic-edit-mcp",
      "args": [
        "serve"
      ],
      "env": {
        "PATH": "system PATH to the binary"
      }
    }
  }
}

You run an MCP server that provides a Model Context Protocol interface for AST-aware code editing. It supports multiple languages and lets you stage, preview, retarget, and persist edits across your codebase, making large refactors and language-aware transformations safer and more efficient.

How to use

To use this MCP server with an MCP client, first start the local editing server and then point your client to the provided command. The server exposes a simple runtime you can invoke from your editor or IDE integration, enabling you to stage edits, preview changes, retarget targets, and persist edits in a single workflow.

How to install

Prerequisites you need before installation are a Rust toolchain (for the cargo command) and a working environment where cargo can install binaries.

Install the MCP server binary using Cargo.

cargo install semantic-edit-mcp

Additional information

Configure your MCP client with the following server entry to run the editing service locally. This example uses a local stdio-based runtime that executes a compiled binary and serves the MCP protocol for code edits.

{
  "mcpServers": {
    "edit": {
      "command": "/path/to/semantic-edit-mcp/semantic-edit-mcp",
      "args": ["serve"]
    }
  }
}

Available tools

preview-edit

Stage an operation and see a preview of the changes.

retarget-edit

Change the targeting of an already-staged operation without rewriting the content.

persist-edit

Execute the currently staged operation.

set-working-directory

Set the working context path for a session.