justrach/codedb

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

解決する課題

codedbは、AIエージェント向けに特別に設計されたコードインテリジェンスサーバーです。単なるファイル読み込みや力任せの検索に頼るのではなく、コードを構造的およびテキスト的にインデックス化する高性能なコンテキストエンジンを提供することで、エージェントが大規模なコードベースを効率的に見つけ、理解する際の問題を解決します。

仕組み

外部依存関係なしのZigで構築されたcodedbは、起動時にプロジェクトの包括的なインデックスを作成します。構造解析（関数、構造体、インポート用）、高速な全文検索のためのトリグラムインデックス、およびO(1)の識別子検索のための転置ワードインデックスを組み合わせて使用します。ポーリング方式のファイルウォッチャーがインデックスをリアルタイムで更新し続けます。このインテリジェンスはModel Context Protocol (MCP)とHTTPサーバーを介して公開され、AIエージェントがファイルシステムを再スキャンすることなく、シンボル、依存関係、アウトラインを照会できるようにします。

対象ユーザー

AIエージェント（Claude Code、Cursor、Windsurf、Devinなど）を使用しており、精度を向上させトークン消費を抑えるために、コードベースの構造やシンボルへの深く低遅延なアクセスを必要とする開発者。

ハイライト

極めて高いパフォーマンス: 事前インデックス化されたクエリは、ripgrepやgrepなどのツールよりも数桁高速です。
MCPネイティブ: 依存関係グラフやシンボル検索を含む、エージェントがコードを探索するための21の特化型ツールを提供します。
トークン効率: 生の行ダンプではなく、構造化された関連性の高い結果を返すため、クエリあたりのトークン使用量を大幅に削減します。
幅広い言語サポート: Zig, C/C++, Python, TypeScript/JavaScript, Rust, Go, PHP, Ruby, HCL, R, Dartの完全なパーサーサポート。
クラウドインテリジェンス: codedb_remoteツールにより、エージェントはローカルクローンを必要とせずに、api.wiki.codesを介してインデックス化された公開GitHubリポジトリを照会できます。