Log inSubmit server
Codeseeker logo

Codeseeker

Indexes codebases for semantic search, directory summaries, symbol lookup, graph traversal, and code analysis through MCP.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Codeseeker

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "codeseeker": {
      "command": "npx",
      "args": [
        "-y",
        "work"
      ],
      "env": {
        "CODESEEKER_STORAGE_MODE": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

We couldn’t confirm it starts correctly

We ran the install command but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

npx -y work

Process exited before answering initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 9d ago.

Overview

The codeseeker MCP server indexes a codebase and exposes hybrid semantic retrieval plus a knowledge graph to AI coding assistants. It combines BM25 matching, 384-dimensional vector embeddings, RAPTOR directory summaries, and AST-derived import relationships, then expands results through graph edges. A single routed MCP tool provides search, symbol lookup, graph, analysis, and indexing actions. Reach for it when assistants need cross-file context, dependency relationships, or semantic matches beyond text search.

Use cases

  • Search for code by behavior or concept
  • Trace imports, calls, and inheritance relationships
  • Locate symbols and their related files
  • Analyze project coding standards
  • Index or reindex a repository for assistant use

Key features

  • BM25 and vector retrieval
  • RAPTOR directory summaries
  • AST-derived knowledge graph
  • Graph expansion across code relationships
  • Symbol lookup and project analysis
  • Single routed MCP tool

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

9/9 checks healthy over the last 41d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 8d ago via OSV.dev · work (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars20Stargazers on the source repository.
npm downloads640Package downloads in the last 30 days.
Last commit20d agoMost recent push to the default branch.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.
Directory activity1 viewsConfig copies, upvotes, and views on AllMCPs.

How Codeseeker works

What codeseeker MCP server does

The codeseeker MCP server gives AI coding assistants an indexed view of a repository. It is designed for questions that require more than matching words in files, such as locating authentication logic, finding related implementation patterns, or tracing dependencies across files.

The server builds a knowledge graph from AST-parsed imports and combines that graph with several retrieval methods. Search results can include source files, test files, symbols, and directory-summary nodes. The system also detects coding standards during analysis, allowing assistants to inspect patterns used by a project.

How it works

Indexing happens before normal querying. During a query, CodeSeeker combines BM25 results with vector search using 384-dimensional Xenova embeddings. Reciprocal Rank Fusion produces an initial set of up to 30 results, including directory summaries generated through the RAPTOR approach.

When a directory summary scores at least 0.5, the retrieval pipeline narrows results to that directory. Otherwise, the full result set continues through the pipeline. Results are then deduplicated so each file keeps its highest-scoring chunk. Additional scoring favors source files, reduces test-file dominance, boosts filename symbol matches, and rewards files with multiple matching chunks.

The highest-ranked results undergo graph expansion. The server follows IMPORTS, CALLS, and EXTENDS relationships from the top 10 results, adding structural neighbors at a reduced score. This helps surface related files that do not contain the query terms directly.

Setup and configuration

Install the package globally with npm, then register the server with an MCP client:

Terminal
npm install -g codeseeker
claude mcp add codeseeker --scope user -e CODESEEKER_STORAGE_MODE=embedded -- codeseeker serve --mcp

The --scope user option makes the registration available across projects opened by Claude Code. A no-install option uses npx:

config.json
{
  "mcpServers": {
    "codeseeker": {
      "command": "npx",
      "args": ["-y", "codeseeker", "serve", "--mcp"],
      "env": { "CODESEEKER_STORAGE_MODE": "embedded" }
    }
  }
}

Other supported setup paths include codeseeker install --vscode, --cursor, or --windsurf. The Claude Code plugin adds synchronization hooks and the /codeseeker:init and /codeseeker:reindex commands. Devcontainers and GitHub Codespaces can install the package during container creation.

Tools and capabilities

The codeseeker MCP server presents one MCP tool with an action routing field. Its documented actions are:

  • search for hybrid semantic and lexical retrieval with graph expansion.
  • sym for symbol-oriented lookup.
  • graph for navigating relationships in the code knowledge graph.
  • analyze for examining project patterns and coding standards.
  • index for creating or updating the indexed representation.

This single-tool design keeps the per-request MCP tool overhead lower than exposing each action as a separate endpoint.

Limitations and notes

The initial index is required and can take roughly 30 seconds to five minutes. Global installation avoids making the first MCP startup responsible for downloading and building dependencies; an uncached npx launch can be slower.

CodeSeeker addresses retrieval rather than specification, testing, or architecture governance. The repository is licensed under Apache 2.0.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Codeseeker

codeseeker is an MCP server that connects AI coding assistants to an indexed codebase through semantic and structural retrieval. Its single routed tool supports search, symbol lookup, graph traversal, analysis, and indexing, combining BM25, vector embeddings, directory summaries, and AST-derived relationships to return relevant code and dependencies.

Install it globally with `npm install -g codeseeker`, then register `codeseeker serve --mcp` with your MCP client. Claude Code users can use the documented `claude mcp add` command, while other editors can use `codeseeker install --vscode`, `--cursor`, or `--windsurf`.

Yes, codeseeker works with Cursor. Install the npm package globally and run `codeseeker install --cursor`, or add the documented MCP configuration manually and restart the editor.

The server provides `search`, `sym`, `graph`, `analyze`, and `index` actions through one routed MCP tool. These cover hybrid code retrieval, symbol lookup, graph navigation, project analysis, and index creation or updates.

It combines BM25 lexical matching, vector embeddings, RAPTOR directory summaries, scoring adjustments, deduplication, and graph expansion. The graph stage follows IMPORTS, CALLS, and EXTENDS relationships from highly ranked results to add structurally related code.

Related MCP servers

All in Developer Tools All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewCodeseeker AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/codeseeker?style=directory)](https://allmcps.com/mcp/codeseeker)
HTML Embed
<a href="https://allmcps.com/mcp/codeseeker"><img src="https://allmcps.com/api/badge/codeseeker?style=directory" alt="Codeseeker on AllMCPs" /></a>