CodeSeeker

CodeSeeker is an MCP server that empowers Claude Code and other AI assistants to understand your codebase through a knowledge graph and hybrid search. By connecting semantic code relationships with practical code patterns, it lets AI navigate your project’s structure, imports, and dependencies to deliver precise, context-aware results.

How to use

You use CodeSeeker by running its MCP server and connecting it to your AI assistant client (such as Claude Code, Cursor, or Claude Desktop). Once configured, Claude can perform semantic code searches, traverse code relationships (imports, calls, inheritance), and read files with context across your project. The tools operate automatically when you search or analyze code, so you don’t need to invoke them manually.

How to install

Prerequisites: ensure you have a supported runtime installed on your system (Node.js v18+ is recommended). You may also need npm or npx depending on your installation path.

# One-line install (easiest)
curl -fsSL https://raw.githubusercontent.com/jghiringhelli/codeseeker/master/scripts/install.sh | sh

# Windows PowerShell one-liner
irm https://raw.githubusercontent.com/jghiringhelli/codeseeker/master/scripts/install.ps1 | iex

Option A: Install via a package manager (recommended for persistent use). For example, using npm to install globally, then configure the MCP host in your editor or IDE integration.

# Cross-platform npm install
npm install -g codeseeker
codeseeker install --vscode      # or --cursor, --windsurf

Option B: Run without permanent installation (npx). This is useful for quick experiments.

npx codeseeker init
npx codeseeker -c "how does authentication work?"

If you prefer Claude Code, you can install as a Claude Code plugin to gain auto-sync hooks and slash commands.

/plugin install codeseeker@github:jghiringhelli/codeseeker#plugin

For development containers, you can auto-install CodeSeeker inside a devcontainer and enable the editor integration there.

{
  "name": "My Project",
  "image": "mcr.microsoft.com/devcontainers/javascript-node:18",
  "postCreateCommand": "npm install -g codeseeker && codeseeker install --vscode"
}

Additional setup for local MCP configuration

You can manually configure your project to connect to CodeSeeker as an MCP server. Create an MCP config file in your editor’s workspace to start the server locally via npx and expose it to Claude Code, Cursor, or Claude Desktop.

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

Available tools

search_code

Hybrid search that combines vector similarity with text and path ranking to find relevant code snippets.

find_and_read

Search and read in one step, returning the matching file content directly.

get_code_relationships

Traverse the knowledge graph to reveal imports, calls, and inheritance relationships.

get_file_context

Read a file along with its related code to provide full context.

get_coding_standards

Identify detected coding patterns and standards used across the project.

index_project

Manually trigger project indexing when needed.

notify_file_changes

Update the index to reflect changes in specific files.

manage_index

Dynamically include or exclude files from the index.