fast code database mcp 20000x faster against rg
Repo killop/codedb-mcp, read from GitHub 2 d ago. killop has not joined Take My Repo.
killop/codedb-mcp is a public repo on GitHub by killop. fast code database mcp 20000x faster against rg. It declares no license on GitHub. Public does not mean open source: without a license, nobody is granted the right to reuse it. It is written mainly in Rust, has 93 stars and last changed on 2026-07-24. Nobody has reviewed it on Take My Repo yet, which says nothing about its quality. Read from GitHub on 2026-11-20.
In the maintainer's words. Shown from GitHub; Take My Repo does not keep a copy.
Local-first MCP toolkit for fast code search, dependency-aware module discovery, visual code atlas pages, and DeepWiki-style repository documentation.
English | 简体中文
Overview • MCP Tools • Token Observer • Code Module Atlas • DeepWiki • Benchmarks • Setup • Skills
codebase-mcp turns a local repository into a persistent MCP code intelligence service. It keeps tree-sitter indexed source data, symbols, references, dependencies, graph metadata, and exact lexical indexes under the target repo's .codedb-mcp directory.
Warm MCP calls are designed to be millisecond-level inside a persistent server process. See Benchmark Snapshot and MCP Tool Benchmark Matrix for warm latency and rg comparisons.
| Area | What It Provides |
|---|---|
| Fast MCP tools | One declarative property-graph language for clustering, dependencies, callers, call paths, state, and control evidence, plus exact bodies/outlines/ranges. |
| Module discovery | Dependency-connected file components plus dependency-weighted label propagation, with terms and paths used as explainable labels and evidence. |
| Code Module Atlas | A packaged meet-blog-style 3D viewer with one star per source file, module/file lists, dependency edges, and file focus/details. |
| DeepWiki | Local repository documentation generated from MCP evidence and the active agent's reasoning, with business-module-first pages and cited source files. |
| Codex token observation | A bundled transcript observer that reads Codex JSONL sessions, measures codedb tool output tokens, and flags high-output lookup patterns. |
| Local deployment | Explicit .codedb-mcp/codedb-mcp.toml, project-local storage, bundled skills, and no hidden environment-variable behavior. |
The server keeps a tree-sitter indexed, project-local code database under .codedb-mcp and exposes five atomic MCP tools:
codedb_graph_query, a Cypher-like MATCH / SHORTEST / WHERE / RETURN / ORDER BY / LIMIT language with scalar/property comparisons, communities, rankable file metrics, typed directed edges, finite paths, call-site arguments, parameter bindings, branch effects, guards, and shared-state joins;codedb_symbol for one exact definition/body;codedb_outline for one exact file;codedb_read for one exact source range;codedb_status for explicit health/freshness checks.Caller, call-path, dependency, flow-atlas, lexical, composite, and administrative wrappers remain CLI/internal. codedb_bundle is not exposed.
The codedb-mcp skill includes a lightweight Codex transcript observer:
node skills\codedb-mcp\scripts\codex-observe.mjs --project u3dclient --since 24h --top 12
It scans ~/.codex/sessions line by line, filters sessions by project cwd, and reports model token counts, tool-output token estimates, codedb call totals, high-output calls, broad reads/searches, non-codedb source lookups, and missed compact-context opportunities. It is a diagnostic script only; it does not modify transcripts or the MCP runtime.

The atlas page is generated by the skills/code-module-atlas skill. It calls the local MCP module-atlas export, converts the result into the bundled meet-blog-style 3D viewer dataset, and shows one star node per source file.
Module boundaries are computed from the dependency-connected file graph first. Inside each connected component, the Rust module planner uses dependency-weighted label propagation; paths and distinctive terms are used for names, evidence, and oversized-component splitting, not as the primary grouping rule. The page then provides a module list, a file list for the selected module, file-to-file dependency edges, and file focus/details.
node skills\code-module-atlas\scripts\build-module-atlas.mjs u3dclient
cd skills\code-module-atlas\assets\viewer
npm run dev -- --port 5174 --strictPort
The skills/deepwiki skill builds local DeepWiki-style documentation from MCP evidence and the active agent's reasoning. It starts from dependency-aware module candidates, then writes business-module-first pages with cited files, entry points, flows, dependencies, and risk notes. It does not require a separate model API.
The intended distribution model is setup-guide first: give an agent setup-for-agent.md, let it create .codedb-mcp and run an index check, then ask the human whether this specific agent should register the MCP server. No model download is required. The codedb-mcp skill is for using the tools after setup, not for installing them.
Benchmark target: u3dclient.
The agent benchmarks below are the last completed pre-property-query baseline from Windows on 2026-07-23. They remain historical controls and are not presented as results for the new codedb_graph_query planner; the consolidated MCP/RG rerun is pending. MCP has no natural-language task router, source-call quota, or forced output clamp; the agent submits explicit graph patterns.
Current index status with the Unity C# benchmark config:
u3dclient\.codedb-mcp.index.*.bin, fingerprints.*.bin, offset-addressed outlines.*.bin / outlines_index.*.bin, lazy word_index.bin/word_hits.bin, lazy text_search_index.bin, lazy callers.bin, lazy deps.*.bin, persistent graph.bin, and manifest-last commits. v32 rebuilds C# field facts used by receiver and shared-state resolution.Startup-to-main-interface trace, one completed MCP/no-MCP pair with the same English prompt and model:
| Variant | Effective tokens | Time | Source-tool calls | Tool output chars |
|---|---|---|---|---|
| codedb-mcp | 122,851 | 414.6s | 41 MCP calls | 244,291 |
shell / rg |
224,922 | 732.8s | 47 commands | 742,368 |
For this lifecycle trace, codedb-mcp reduced effective tokens by 45.4%, elapsed time by 43.4%, and tool-output characters by 67.1%. The answer connected launch, the AOT/hot-update state handoff, framework initialization, login/full-data readiness, city/scene transition, the exact main-panel open, and the final OnShow readiness body.
Broader feature-analysis reference runs used the same English prompts and model. MCP rows are completed non-regressing runs from the graph-only series; the RG controls were run together with codedb disabled. They demonstrate current quality and cost, not a deterministic SLA: repeated wide runs still show agent-level convergence variance.
| Scenario | codedb-mcp | shell / rg |
Effective-token change | Tool-output change |
|---|---|---|---|---|
| World-map marching | 228,915 tokens / 796.4s / 161 calls / 479,094 chars | 253,905 tokens / 787.5s / 102 commands / 1,023,944 chars | 9.8% lower | 53.2% lower |
| Hero attributes and power | 207,282 tokens / 569.6s / 129 calls / 514,907 chars | 227,248 tokens / 656.9s / 104 commands / 668,652 chars | 8.8% lower | 23.0% lower |
| Alliance rally/create/join | 171,449 tokens / 454.0s / 113 calls / 397,873 chars | 196,057 tokens / 619.1s / 37 commands / 851,689 chars | 12.6% lower | 53.3% lower |
Accuracy review found the completed MCP answers materially covered the requested end-to-end behavior and distinguished active runtime code from comments/legacy paths. The main remaining issue is call count and convergence variance on broad multi-branch questions. A final consolidated rerun with the same model could not complete because the Codex account began rejecting gpt-5.6-sol as unsupported; those failed runs are excluded rather than reported as zero-token wins.
Index and cache baseline:
| Scenario | Time | Peak WS / private | Notes |
|---|---|---|---|
| Cold rebuild | 13.818s | 226.9 / 220.2 MB | historical pre-v28 result; rerun pending for the graph-only cache |
| Cache-hit index open | 0.741s | 107.8 / 106.1 MB | unchanged files/config, manifest cache hit |
| Status open | 0.454s | 14.4 / 8.1 MB | count/status command with existing cache |
| Trigram text sidecar size | 107.7 MB | n/a | sorted trigram lookup plus contiguous file-id postings |
Incremental cache maintenance on the same u3dclient runtime C# config:
| Scenario | Time | Cache result | Notes |
|---|---|---|---|
Add 1,000 small .cs files |
1.508s warm apply | live-incremental |
parses only new files and updates the compact cache path |
Modify 1,000 small .cs files |
1.544s warm apply | live-incremental |
reuses parsed file content for dependency refresh |
Delete 1,000 small .cs files |
0.504s warm apply | live-incremental |
filters current files and dependency sidecars without a full rebuild |
The table is intentionally three columns so it fits GitHub README pages without horizontal scrolling. Rows marked "after load" exclude the first lazy sidecar load in the same process. codedb_text_search rows use same-query warm samples after one warmup call; a first unseen full-result text query still pays the candidate-file line scan, usually around 15-30ms on u3dclient.
| Tool / Purpose | MCP benchmark | rg comparison |
|---|---|---|
codedb_graph_queryTyped property-graph evidence chains |
property-query benchmark rerun pending; correctness smoke covers shortest call/dispatch paths, call-site guards, argument-to-parameter binding, branch PREVENTS/REACHES, and shared-state producer joins |
no equivalent single rg command |
codedb_indexBuild/rebuild local index |
cold rebuild 13.818s; peak 226.9 / 220.2 MB | none |
codedb_statusHealth, counts, scan state |
one-shot status open 0.454s; cache hit | none |
codedb_versionServer/package version |
trivial response; no project index load | none |
codedb_treeIndexed tree with language, lines, symbols |
8.782ms | partial file list only |
codedb_outlineOne-file symbol outline |
sampled files 0.088-0.351ms; 100-call p95 0.214ms after first load | none |
codedb_symbolSymbol definition lookup |
2.021ms | regex approximates text only |
codedb_text_searchTrigram full-text and regex search |
same-query warm exact PoolManager 0.202ms, Joystick 0.442ms; scoped NetworkListenerManager 0.103ms; Alliance regex 0.148ms |
equivalent rg: 5.007s, 5.859s, 77.011ms, and 103.702ms; codedb is about 24,840x / 13,250x / 748x / 701x faster on these warm text routes |
codedb_searchSymbol/word-trigram lexical ranking |
historical timings pending graph-only rerun | regex route delegates to codedb_text_search |
codedb_contextGraph atlas or scoped graph evidence |
historical timings pending graph-only rerun | replaces broad search/outline/deps setup loops |
codedb_contextBudgeted source-context excerpts |
PoolManager 7.050ms with max_chars=10000; business phrase 29.037ms with max_chars=12000; sampled output about 2.5k-3.0k tokens |
replaces repeated read calls; output is capped by max_chars |
codedb_wordExact identifier inverted index |
101.526ms including lazy word sidecar access | partial word grep only |
codedb_callersDefinition-anchored references |
PoolManager 12.722ms avg, 8ms steady samples; Joystick 17.968ms |
no semantic anchor |
codedb_hotRecently modified indexed files |
2.116ms | none |
codedb_depsDirect/reverse/transitive file deps |
depends_on 0.096ms; imported_by first sidecar path 170.495ms, then sub-ms samples | none |
codedb_readIndexed file or line-range read |
0.562ms | partial file print only |
codedb_editRead-only compatibility stub |
trivial error response | none |
codedb_changesFiles changed since sequence |
7.849ms | none |
codedb_snapshotJSON snapshot of files/symbols/deps |
1.213s | none |
codedb_remoteRemote compatibility stub |
trivial error response | none |
codedb_projectsProjects loaded in server process |
0.013ms | none |
codedb_findFuzzy file/path lookup |
validation samples 20-26ms; matrix sample 47.150ms | no fuzzy ranking |
codedb_queryfind/search/filter/limit/outline pipeline |
validation samples 9-60ms; matrix sample 63.546ms | no equivalent single tool |
codedb_globGlob over indexed paths |
Alliance .cs glob 4.465ms |
rg --files -g 52.961ms; codedb is 11.9x faster |
codedb_lsImmediate indexed directory children |
1.421ms | partial file list only |
codedb_module_atlasModule/file atlas JSON export |
warm export 7.278s; full sampled export 7.960s, peak 286.2 / 289.1 MB, 18,852 file points, 1,742 modules | none |
Java smoke benchmark on gameserver:
| Scenario | Files | Chunks | Symbols | Time | Peak memory |
|---|---|---|---|---|---|
| Historical cold build before graph-only cache v28 | 6,940 | 13,966 | 245,238 | 3.939s | 212.7 / 212.4 MB |
| Cache-hit index open | 6,940 | 13,966 | 245,238 | 0.394s | 73.7 / 69.3 MB |
Multi-language smoke coverage includes C#, Java, Rust, Python, Lua, TypeScript, C, and C++ parser paths: 8 files, 8 chunks, 14 symbols, 0.069s, peak 2.0 / 0.5 MB.
Rust smoke check on this repository: 32 indexed files, 1,183 chunks, 2,214 symbols, 0.372s index time, peak 170.9 / 162.1 MB; codedb_outline, codedb_search, and codedb_deps all returned Rust results.
setup-for-agent.md.<repo-root>\.codedb-mcp.<repo-root>\.codedb-mcp\codedb-mcp.toml from the demo config and shows the human the scan scope.extensions, root_paths, include_paths, exclude_paths, and skip_dirs before first indexing./mcp.The MCP command shape is:
<package-root>\skills\codedb-mcp\assets\codebase-mcp.exe --config <repo-root>\.codedb-mcp\codedb-mcp.toml mcp <repo-root>
This project intentionally keeps installation explicit: setup prepares local project files, while the agent/user chooses when and where to register MCP.
<repo-root>/.codedb-mcp/codedb-mcp.toml..codedb-mcp. Delete that directory to remove local cache and generated wiki/index data.FileEntry/Symbol model. C#/Java typed callers and dependencies remain the strongest path because their namespace/package import rules are implemented on top of that shared AST output.Community/File graph queries rather than a query model.codedb_module_atlas output from a dependency-connected file graph with label propagation, dependency cohesion, key symbols, and c-TF-IDF-like labels..codedb-mcp/codedb-mcp.toml. There are no environment-variable switches for indexing behavior..codedb-mcp. Deleting that directory removes all generated data for the repo..gitignore behavior, scan roots, include paths, exclude globs, and skip dirs. Nested Git worktrees/submodules under the target root are scanned as normal source directories. Unity runtime scans can be limited to Assets, Packages, and Library/PackageCache while excluding **/Editor/**.FileEntry/Symbol model for every language and visits declarations without descending into large method bodies.require() imports, and graph nodes, but not Roslyn/JDT-level semantic binding.codedb_text_search adds a codedb-style trigram sidecar with sorted lookup entries and contiguous file-id postings for fast exact/regex text search. codedb_search uses BM25 plus exact symbol/word evidence; it does not load a query model.justrach/codedb: full file bodies, chunk preview text, repeated chunk file paths, repeated language/kind strings, word-index hits, caller results, forward/reverse dependencies, and graph objects are not all resident by default. Tools read exact lines, offset-addressed outlines, trigram postings, word hits, caller sidecars, dependencies, or graph data on demand. Watcher refreshes are event-queued, parse only changed files, reuse old dependency sidecars, and let lazy search sidecars rebuild when their source fingerprint changes.MATCH SHORTEST uses bidirectional connector search.codedb_module_atlas first splits files by dependency-connected components, then does dependency-weighted label propagation inside each component. Path and token terms are used for naming, evidence, and oversized-component splitting, not as the primary grouping rule. It exports Embedding Atlas-ready JSON.rmcp SDK over stdio. Tools operate against a warm in-process index and expose atomic graph/source operations for progressive evidence gathering.setup-for-agent.md owns installation guidance. skills/codedb-mcp is standalone for tool usage and includes the executable, config template, MCP reference, and tool guidance. skills/deepwiki builds local DeepWiki-style docs from MCP evidence plus the active agent's reasoning. skills/code-module-atlas calls codedb_module_atlas and packages the local meet-blog-style module/file graph webpage.Default config path:
<repo-root>/.codedb-mcp/codedb-mcp.toml
The repo includes a working example at .codedb-mcp/codedb-mcp.toml and a distributable template at skills/codedb-mcp/assets/codedb-mcp.toml.template.
Important defaults:
[scan]
extensions = ["cs", "java", "rs", "py", "pyw", "lua", "js", "jsx", "mjs", "cjs", "ts", "tsx", "c", "h", "cc", "cpp", "cxx", "hpp", "hh", "hxx"]
max_file_bytes = 50000000
respect_gitignore = true
root_paths = []
include_paths = ["Library/PackageCache"]
exclude_paths = []
[logging]
enabled = false
file = ".codedb-mcp/codedb-mcp.log"
queue_capacity = 8192
flush_interval_ms = 500
[storage]
enabled = true
dir = ".codedb-mcp"
There are no environment-variable toggles. Edit the config file explicitly. root_paths can limit scanning to source roots such as Assets, Packages, and Library/PackageCache; include_paths adds extra roots even when a parent is skipped; exclude_paths accepts globs such as **/Editor/** for Unity runtime-only scans. respect_gitignore=true reads project .gitignore files, but nested Git worktrees/submodules inside the target root are still indexed unless excluded by skip_dirs, exclude_paths, or file extension rules. [logging] is disabled by default; when enabled, MCP tool calls and file-watch digest batches are written through a bounded non-blocking queue and background writer. Tool lines include elapsed_ms, status, and failure_reason for failures. Watcher digest lines include queued event counts, changed/deleted counts, digest status, elapsed time, and cache stats. Queue overflow drops log lines instead of slowing indexing or MCP.
Build:
cargo build --release
Run MCP directly:
target\release\codebase-mcp.exe --config u3dclient\.codedb-mcp\codedb-mcp.toml mcp u3dclient
Quick CLI checks:
target\release\codebase-mcp.exe --config u3dclient\.codedb-mcp\codedb-mcp.toml index u3dclient
target\release\codebase-mcp.exe --config u3dclient\.codedb-mcp\codedb-mcp.toml search "network listener manager" u3dclient -k 5
target\release\codebase-mcp.exe --config u3dclient\.codedb-mcp\codedb-mcp.toml --root u3dclient tool codedb_status "{}"
MCP mode answers the protocol handshake before the initial index finishes, then builds the default project index in the background. Early tool calls may wait for that first build. Watching is enabled by default through [watch] enabled = true and poll_interval_seconds = 5; filesystem events are queued and applied as one serialized batch on each tick. The same tick checks the config file hash. If scan scope, extensions, include/exclude paths, max file size, gitignore behavior, or storage settings change while MCP is running, codedb-mcp keeps serving the old index, performs one full background reindex, then atomically swaps to the new index and rebuilds watcher roots. Parse or reindex failure keeps the old index. Cache commits are manifest-last and generation-based: if the process is killed mid-index, the previous manifest still points to the previous usable cache, partial new sidecars are ignored, and stale unreferenced generation files are cleaned on the next startup. Lazy sidecars such as text search, word hits, and callers are source-validated and rebuilt on demand instead of synchronously deleted during reload. Use --no-watch for static benchmark runs.
codedb_search accepts queries:
{
"max_results": 3,
"queries": [
"PoolManager",
{
"query": "Joystick",
"path_glob": "Assets/Plugins/3rdPlugins/Joystick Pack/**"
},
{
"query": "NetworkListenerManager",
"regex": true,
"compact": true
}
]
}
codedb_callers accepts targets:
{
"max_results": 10,
"targets": [
{
"name": "PoolManager",
"definition_path": "Assets/Scripts/HotFix/3rdExtend/Runtime/PoolManager/PoolManager.cs",
"definition_line": 26
},
{
"name": "Joystick",
"definition_path": "Assets/Plugins/3rdPlugins/Joystick Pack/Scripts/Runtime/Base/Joystick.cs",
"definition_line": 8
}
]
}
codedb_read accepts paths:
{
"compact": true,
"paths": [
"Assets/Scripts/HotFix/3rdExtend/Runtime/PoolManager/PoolManager.cs",
{
"path": "Assets/Plugins/3rdPlugins/Joystick Pack/Scripts/Runtime/Base/Joystick.cs",
"line_start": 1,
"line_end": 40
}
]
}
codedb_module_atlas exports dependency-connected module/file atlas JSON:
target\release\codebase-mcp.exe --config u3dclient\.codedb-mcp\codedb-mcp.toml --root u3dclient tool codedb_module_atlas "{`"path_prefix`":`"Assets/Scripts`",`"limit`":40,`"min_files`":2}"
The skills/ directory is intended to be copied as a standalone package.
setup-for-agent.md: installation guide for agents. It writes project-local scan/storage config and runs an index check without downloading a model.skills/codedb-mcp: includes assets/codebase-mcp.exe, a config template, MCP registration reference, tool guidance, and scripts/codex-observe.mjs for Codex transcript token diagnostics. It does not own setup.skills/deepwiki: creates DeepWiki-style local documentation using local codedb_* tools plus the active agent's reasoning. It emphasizes business module boundaries over folder-only or community-only grouping.skills/code-module-atlas: creates a local 3D module/file atlas webpage by calling codedb_module_atlas, then adapting the bundled meet-blog-style viewer. Generated repo-specific JSON stays ignored.killop/codedb-mcp is a public repo on GitHub by killop. fast code database mcp 20000x faster against rg.
It declares no license on GitHub. Public does not mean open source: without a license, nobody is granted the right to reuse it.
Its maker has not tagged a system, so it is unknown here. Its README says what it needs.
Open "Take it" on its page: Take My Repo writes an install plan for your machine and hands it to your AI agent (Claude Code, Codex or Cursor), which asks you before each step. Take My Repo has not tested it on any machine.
Its last change on GitHub was on 2026-07-24. Take My Repo does not judge from that whether it is maintained.
Nobody has reviewed it on Take My Repo yet, which says nothing about its quality.

A wonderful list of Game Development resources.
线性工作流下,场景相机和UI相机,独立的分辨率,并且UI能够保持在 Gamma 颜色空间下工作
unity-mcp driven by tencent puerts , invoke js/ts call c# in your cell phone and unity editor