# codeseeker

Combines lexical and vector retrieval with an AST knowledge graph to trace dependencies and logic across codebases.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 20
- Author: jghiringhelli
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/jghiringhelli/codeseeker
- Updated: 2026-10-04
- HTML: https://affpapa.org/en/nevibecode/mcp/codeseeker

## What it does

CodeSeeker merges BM25 lexical matching with 384-dimensional Xenova embeddings and RAPTOR directory summaries. During indexing, it parses AST imports to construct a dependency graph of calls and inheritance across files.

Incoming queries run through Reciprocal Rank Fusion, downranking test files and traversing structural graph edges. This surfaces indirect dependencies that basic text search skips.

Building the repository index requires between 30 seconds and 5 minutes upfront. Graph retrieval cannot function without completing this initial indexing step.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add codeseeker -- npx -y codeseeker
```

### Codex

**Platform CLI**
```bash
codex mcp add codeseeker -- npx -y codeseeker
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "codeseeker": {
            "command": "npx",
            "args": [
                "-y",
                "codeseeker"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "codeseeker": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "codeseeker"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add codeseeker npx -y codeseeker
```

## When to use it
- locate token refresh mechanisms across distributed files
- trace import chains and class inheritance hierarchies
- suppress test file noise in architectural queries
- detect dead code by traversing AST relationship graphs

## Example prompts
- Locate the authentication handler and list all modules that import it
- Find token verification logic and inspect its direct callers

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

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