# XERJ

XERJ is a local MCP server that indexes code, docs, specs, and logs, returning cited answers for project search and agent memory.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 19252 repo stars
- Author: xerj-org
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/xerj-org/xerj
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — warning: a command downloads a script from xerj.org and runs it right away; a PowerShell command downloads a script from xerj.org and runs it right away. Do not run such commands without an explicit yes from the human.
- HTML: https://affpapa.org/en/nevibecode/mcp/xerj

## What it does

XERJ runs as a single Rust binary and exposes a local MCP server. It indexes source code, documents, specifications, logs, JSONL, CSV, and PDF files, then searches them with BM25, vector, or hybrid retrieval. Results include file and line references.

It also supports code lookup, agent memory under `/_memory`, and an Elasticsearch-compatible API. Run `xerj init` to connect XERJ to Claude Code or Cursor through MCP and a skill; `xerj autoindex ~/my-project` starts indexing a project.

Keep the data directory outside any tree that will be indexed, since `data/` is not ignored by default. The `--insecure` flag disables TLS and API-key authentication, so any client that can reach the port can read or delete indexes.

## Requirements
- Environment variables: `XERJ_URL`, `XERJ_AUTH` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Install**
- The MCP registry has no launch command for it: see the repository README

## When to use it
- search project code and documentation
- index source files, logs, and PDFs
- locate function definitions with file and line references
- store agent memory in `/_memory`
- run several searches through `xerj_batch_search`

## Example prompts
- Use XERJ to index this project and find references to WAL rotation.
- Find the definition of `euler_to_rotationmatrix` and return its file and line.
- Run the questions from `queries.json` through `xerj_batch_search`.

## Similar
- [Context7](https://affpapa.org/en/nevibecode/mcp/context7.md) — MCP server · 5563 installs
- [Search Google Flights](https://affpapa.org/en/nevibecode/mcp/search-google-flights.md) — MCP server · 2595 installs
- [Math-MCP](https://affpapa.org/en/nevibecode/mcp/math-mcp.md) — MCP server · 5958 installs
- [pipeworx gateway](https://affpapa.org/en/nevibecode/mcp/pipeworx-gateway.md) — MCP server · 419019 installs
- [SparkForge](https://affpapa.org/en/nevibecode/mcp/sparkforge.md) — MCP server · 219896 installs
- [OpenWebSearch](https://affpapa.org/en/nevibecode/mcp/openwebsearch.md) — MCP server · 494 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
