# Nexus-MCP

> Nexus-MCP is an open-source MCP server for developer tools. Local hybrid code search and code graph so coding agents read less to find the right file. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, macOS, Linux, Windows
- **Website:** https://jaggernaut007.github.io/nexus-mcp/
- **Repository:** https://github.com/jaggernaut007/nexus-mcp
- **MCP Registry name:** io.github.jaggernaut007/nexus-mcp
- **Categories:** developer tools
- **Listing updated:** 2026-11-14

## About

Nexus-MCP runs on your machine and answers a plain-language question about a codebase with the relevant code, instead of leaving the agent to chain grep and file reads. It combines hybrid search with a code graph, needs no API keys and is MIT licensed. The first run downloads an embedding model, and `NEXUS_OFFLINE=1` blocks further downloads.

The project publishes its measurements. On ten open-source repos in ten languages it reports a median of 95% fewer tokens to reach the right file and 9 times faster search than Grep and Read, with the right file first in 67 to 93% of cases against 20 to 50%. In live Claude Code runs on 11 repos, cost per task was lower on 8, with 64 of 66 tasks correct against 61. Several repos show little or no gain, and the site keeps those results visible.

Setup is `uvx --python 3.12 nexus-mcp-ci setup`, which finds MCP clients, shows each change and asks before writing. An offline `eval` command lets you measure it on your own code first.

## Features

- **Hybrid code search:** Finds code from a plain-language question rather than a grep tour.
- **Code graph:** Adds structural relationships between code elements.
- **Published benchmarks:** Per-repo results for tokens, time and cost, including losses.
- **Local and keyless:** Runs on your machine with no API keys; MIT licensed.
- **Guided setup:** `setup` detects clients and asks before writing config.
- **Offline eval:** Measure it on your own repo with no LLM.

## Good for

- Cut token use when an agent explores a large repo
- Locate the right file in an unfamiliar codebase
- Benchmark retrieval quality on your own code
- Give Claude Code, Codex or Cursor shared code search

## Install

### Claude Code (Terminal)

```sh
claude mcp add nexus-mcp -- uvx nexus-mcp-ci
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "nexus-mcp": {
      "command": "uvx",
      "args": [
        "nexus-mcp-ci"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "nexus-mcp": {
      "command": "uvx",
      "args": [
        "nexus-mcp-ci"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "nexus-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "nexus-mcp-ci"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "nexus-mcp": {
      "command": "uvx",
      "args": [
        "nexus-mcp-ci"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "nexus-mcp": {
      "command": "uvx",
      "args": [
        "nexus-mcp-ci"
      ]
    }
  }
}
```

## FAQ

### Does it need API keys?

No. It runs locally; the embedding model downloads on first run.

### How do I install it?

Run `uvx --python 3.12 nexus-mcp-ci setup` (requires uv).

### Where is the index stored?

In `.nexus` inside the project by default, changeable with `NEXUS_STORAGE_DIR`.

### Does it always save money?

No. Live runs were cheaper on 8 of 11 repos, with a few roughly flat.

### Is Nexus-MCP free?

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

### How do I add Nexus-MCP to Claude Code?

Run this command in your terminal: claude mcp add nexus-mcp -- uvx nexus-mcp-ci

### What are the best alternatives to Nexus-MCP?

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

## 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/nexus-mcp-2
