# PurRAssist

> PurRAssist is an open-source MCP server for developer tools. Recover intended JSON, tool calls, names and Markdown edits from imperfect model output. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, macOS, Windows, Linux
- **Repository:** https://github.com/blackcat-informatics/purrassist
- **MCP Registry name:** io.github.Blackcat-Informatics/purrassist
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools), [AI models and LLM tooling](https://ai-powered.com/categories/ai-and-llm)
- **Listing updated:** 2026-11-18

## About

You give the decoder a schema and an effort level; it searches combinations of corrections, validates the whole result and returns a receipt of what changed. The README stresses that a schema-valid guess is still a guess, so ambiguous alternatives stay visible and outcomes are labelled resolved, best guess, ambiguous or unresolved.

The same engine ships as a Rust crate, a stdio MCP server and a CLI, and the CLI and MCP results are checked to match tool by tool. Its pure core has no third-party runtime dependencies and includes its own JSON parser, schema validator and fuzzy matching such as Damerau-Levenshtein, Soundex and contextual path matching.

Other capabilities listed include source-bound text edits with undo, Markdown structural editing, Tree-sitter-based repairs for Python, Rust, JavaScript and TypeScript, and recovery of tool calls from raw output across 23 built-in dialects. Starting the server creates a `.purrassist/` journal folder in its root. Version 0.1.0.

## Features

- **Schema-guided recovery:** Repairs malformed JSON against a schema and reports evidence for each change.
- **Visible ambiguity:** Returns alternatives instead of hiding uncertain guesses.
- **Tool-call recovery:** Parses raw model output in 23 dialects and resolves it against typed tool declarations.
- **Fuzzy matching:** Matches names and paths with edit distance, phonetics and aliases.
- **Markdown editing:** Structural section, list and table edits with overlap checks and undo.
- **Three interfaces:** Use it as a Rust crate, MCP server or CLI with the same results.

## Good for

- Fix a model's near-valid JSON
- Parse tool calls from open-model output
- Match a misspelled file path to a real one
- Apply fuzzy text edits safely with undo

## Install

### Claude Code (Terminal)

```sh
claude mcp add purrassist -- npx -y purrassist-cli
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "purrassist": {
      "command": "npx",
      "args": [
        "-y",
        "purrassist-cli"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "purrassist": {
      "command": "npx",
      "args": [
        "-y",
        "purrassist-cli"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "purrassist": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "purrassist-cli"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "purrassist": {
      "command": "npx",
      "args": [
        "-y",
        "purrassist-cli"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "purrassist": {
      "command": "npx",
      "args": [
        "-y",
        "purrassist-cli"
      ]
    }
  }
}
```

## Tools

- `match_strings`: Match strings with fuzzy and phonetic rules.
- `validate_json`: Validate JSON against a schema.

## FAQ

### How do I install the server?

Run `cargo install purrassist-cli`, then `purrassist mcp --root <workspace>`.

### Does it modify files?

It has root-scoped file tools that keep transaction journals in `.purrassist/`.

### Does the core use third-party libraries?

The pure core has zero third-party runtime dependencies; the syntax crate uses Tree-sitter.

### What version is it?

0.1.0, published on crates.io.

### Is PurRAssist free?

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

### How do I add PurRAssist to Claude Code?

Run this command in your terminal: claude mcp add purrassist -- npx -y purrassist-cli

### What are the best alternatives to PurRAssist?

The closest alternatives to PurRAssist are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

## Where this comes from

- Description: written from the project's README.
- 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.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [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.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers 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.

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