# Rift

> Rift is an open-source MCP server for developer tools. MCP server that lets AI agents query diffs of huge text files without reading them. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Linux, vscode, API
- **Website:** https://rubtsov-stan.github.io/rift/guide/mcp/
- **Repository:** https://github.com/rubtsov-stan/rift
- **MCP Registry name:** io.github.rubtsov-stan/rift-mcp
- **Categories:** developer tools
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

```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"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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"
      ]
    }
  }
}
```

## Tools

- `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.

## 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.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/rift
