Codedb

v1.0.0Search & Data Extractionstable

Zig code intelligence server and MCP toolset for AI agents. Fast tree, outline, symbol, search, read, edit, deps, snapshot, and remote GitHub repo queries.

agentic-aiagentsanthropiccursorgemini
Share:
823
Stars
0
Downloads
0
Weekly
0/5

What is Codedb?

Codedb is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to zig code intelligence server and mcp toolset for ai agents. fast tree, outline, symbol, search, read, edit, deps, snapshot, and remote github repo queries.

Zig code intelligence server and MCP toolset for AI agents. Fast tree, outline, symbol, search, read, edit, deps, snapshot, and remote GitHub repo queries.

This server falls under the Search & Data Extraction category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Zig code intelligence server and MCP toolset for AI agents.

Use Cases

Zig code intelligence and semantic search
Remote GitHub repository analysis for AI
justrach

Maintainer

LicenseBSD-3-Clause
Languagezig
Versionv1.0.0
UpdatedMay 22, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx codedb

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Codedb

Codedb is a native Zig-powered code intelligence server and MCP toolset that gives AI agents fast, structured access to codebases. It provides 21 MCP tools covering file trees with symbol counts, function and struct outlines, symbol definitions, trigram-accelerated full-text search, inverted index word lookup, call graph traversal, dependency analysis, and even remote GitHub repository queries — all without cloning. Benchmarked at up to 1,340x faster than CLI invocation, it makes AI-driven code exploration and refactoring significantly more efficient.

Prerequisites

  • A supported OS (Linux, macOS, or Windows)
  • An MCP-compatible client such as Claude Code, Cursor, Windsurf, or Devin
  • curl for the automated installer (or npm/npx for zero-install usage)
  • CODEDB_NO_TELEMETRY=1 set if you prefer to disable anonymous usage analytics (optional)
1

Install codedb via the automated installer

Run the install script to download the native binary and auto-register codedb as an MCP server across supported AI coding tools.

curl -fsSL https://codedb.codegraff.com/install.sh | bash
2

Alternatively, use npx for zero-install

Use the npm package codedeebee for a zero-install MCP server start. Note: the npm package name is codedeebee, but the CLI command remains codedb.

npx -y codedeebee mcp
3

Start the MCP server for your project

Point codedb at your project directory. It will index the codebase and start a JSON-RPC/MCP server that AI clients can connect to.

codedb mcp /path/to/your/project
4

Verify the CLI is working

Run a quick tree and symbol search to confirm codedb is indexing your project correctly.

codedb tree /path/to/your/project
codedb outline src/main.zig
codedb find MyFunction
5

Configure your MCP client

Add codedb to your Claude Desktop or Cursor configuration so AI agents can use its 21 tools during conversations.

Codedb Examples

Client configuration

Claude Desktop configuration using the codedeebee npm package for zero-install MCP server startup.

{
  "mcpServers": {
    "codedb": {
      "command": "npx",
      "args": ["-y", "codedeebee", "mcp", "/path/to/your/project"],
      "env": {
        "CODEDB_NO_TELEMETRY": "1"
      }
    }
  }
}

Prompts to try

Example prompts that leverage codedb's code intelligence tools.

- "Show me the file tree of this project with symbol counts for each file"
- "Find all definitions of the AuthManager symbol across the codebase"
- "Search for all call sites of the handleRequest function"
- "Show the dependency graph for the payments module including transitive deps"
- "Query the public GitHub repo github.com/golang/go for all exported interfaces in the net/http package"

Troubleshooting Codedb

Install script fails or binary not found after installation

Ensure curl is installed and you have write access to the install directory (usually ~/.local/bin or /usr/local/bin). Add the install directory to your PATH, then verify with 'codedb --version'.

Symbol search returns no results for a known function

Run 'codedb tree /path/to/project' to confirm the project is indexed. codedb automatically excludes .env files, credentials, and key files — ensure your function is in a non-excluded source file.

codedb_remote tool returns errors for GitHub repos

Remote GitHub queries work on publicly indexed repositories. Private repos or very new repos may not be indexed yet. For private repos, run codedb locally with 'codedb mcp /path/to/cloned/repo'.

Frequently Asked Questions about Codedb

What is Codedb?

Codedb is a Model Context Protocol (MCP) server that zig code intelligence server and mcp toolset for ai agents. fast tree, outline, symbol, search, read, edit, deps, snapshot, and remote github repo queries. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Codedb?

Follow the installation instructions on the Codedb GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Codedb?

Codedb works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Codedb free to use?

Yes, Codedb is open source and available under the BSD-3-Clause license. You can use it freely in both personal and commercial projects.

Browse More Search & Data Extraction MCP Servers

Explore all search & data extraction servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "codedb": { "command": "npx", "args": ["-y", "codedb"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Codedb?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides