Skip to content
MCP server

Rift

MCP server that lets AI agents query diffs of huge text files without reading them

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, macOS, Linux
Runs
Locally
Version
0.3.4
Listing updated
today

About Rift

Rift is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

The README describes Rift as a tool for diffing large text files under a fixed heap limit, and rift-mcp is its MCP front end. Instead of loading two multi-gigabyte files into a model's context, the client asks targeted questions: how many lines differ, where the first differences are, what the next difference is after a given line, and the text of one change cut to a size the client sets.

The server builds a diff for a pair of files once and keeps it for later calls, so only the first call scans the files. It opens files read-only and refuses symbolic links, directories, devices and pipes. Memory per diff is capped at 256M, with a default of 64M, and the server limits how many diffs stay alive at once.

It suits agents and developers working with database dumps, CSV or NDJSON exports and generated fixtures where ordinary diff tools run out of memory. The guide shows setup for Claude Code, Claude Desktop, Cursor and VS Code, and the bundle for Claude Desktop does not cover Windows yet.

Install

Run in a terminal

claude mcp add rift-mcp -- npx -y https://github.com/rubtsov-stan/rift/releases/download/v0.3.4/rift-mcp-0.3.4.mcpb

Add to claude_desktop_config.json

{
  "mcpServers": {
    "rift-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/rubtsov-stan/rift/releases/download/v0.3.4/rift-mcp-0.3.4.mcpb"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "rift-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/rubtsov-stan/rift/releases/download/v0.3.4/rift-mcp-0.3.4.mcpb"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "rift-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/rubtsov-stan/rift/releases/download/v0.3.4/rift-mcp-0.3.4.mcpb"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "rift-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/rubtsov-stan/rift/releases/download/v0.3.4/rift-mcp-0.3.4.mcpb"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "rift-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/rubtsov-stan/rift/releases/download/v0.3.4/rift-mcp-0.3.4.mcpb"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (3)

Taken from the project documentation; the running server may differ.

summary
Summarizes the diff of two text files: line counts, segment counts by status, first differing ranges and memory use.
next_difference
Returns the first differing range of A that starts after a given line.
hunks_at
Returns the difference in or next to a given line of A as unified diff text, cut at max_lines.

What it does

Summary of differences
Reports line and byte counts, segment counts by status and the first differing ranges for two files.
Step through changes
Returns the next differing range after a given line so a client can walk the diff one change at a time.
Bounded hunk text
Returns the unified diff lines for one change, capped by a line count and a 64 KiB text limit.
Read-only, memory-capped diffs
Opens files read-only and limits each diff's memory budget, with a server-wide cap on live diffs.
Kept diffs between calls
Builds the diff once per file pair and reuses it for later calls on the same pair.

Good for

  • Asking an agent how large a difference is between two database dumps before a migration
  • Finding the first changed region in a multi-gigabyte CSV or NDJSON export
  • Reviewing the exact lines of one change without loading both files into context
  • Comparing generated fixtures or golden files that are too big for standard diff

Pricing

Open source

Dual-licensed MIT and Apache 2.0; free to use.

Prices change. Check rubtsov-stan.github.io before you buy.

Rift FAQ

Which MCP clients does the guide cover?

The guide gives setup snippets for Claude Code, Claude Desktop, Cursor and VS Code.

Does the server modify the input files?

No. The guide says it opens files read-only.

What is the memory limit for a diff?

The default is 64M per diff and at most 256M for one diff, set with the mem argument.

Is the diff minimal?

No. The README says the diff is not minimal and can show a change as larger than the smallest possible one.

Is the bundle available on Windows?

Not yet. The guide says the Claude Desktop bundle covers macOS and Linux only.

Is Rift free?

Yes. Rift is open source, so you can use and self-host it for free.

How do I add Rift to Claude Code?

Run this command in your terminal: claude mcp add rift-mcp -- npx -y https://github.com/rubtsov-stan/rift/releases/download/v0.3.4/rift-mcp-0.3.4.mcpb

What are the best alternatives to Rift?

The closest alternatives to Rift are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Where this comes from

  • Description: written from the project's README, the project's website and its MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers

Alternatives to Rift

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 467K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.8K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    • Remote
    • Open source
    • 34.6K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools