GitHub - DeusData/codebase-memory-mcp：高性能代码智能 MCP 服务器。将代码库索引到持久化知识图谱——平均毫秒级处理仓库。

codebase-memory-mcp

面向 AI 编程 Agent 的最快、最高效的代码智能引擎。 可在毫秒内完成对普通代码库的全量索引，Linux 内核（2800 万行代码，75K 个文件）仅需 3 分钟。结构化查询响应时间低于 1ms。以单一静态二进制文件的形式分发，支持 macOS、Linux 和 Windows——下载、运行 install，搞定。

通过 tree-sitter AST 分析实现对全部 158 种编程语言的高质量解析，并结合 Hybrid LSP 语义类型解析，支持 Python、TypeScript / JavaScript / JSX / TSX、PHP、C#、Go、C、C++、Java、Kotlin 和 Rust——生成涵盖函数、类、调用链、HTTP 路由及跨服务链接的持久化知识图谱。14 个 MCP 工具。零依赖。可无缝接入 11 种编程 Agent。

研究 — 本项目的设计思路与基准测试详见预印本 Codebase-Memory: Tree-Sitter-Based Knowledge Graphs for LLM Code Exploration via MCP（arXiv:2603.27277）。在 31 个真实代码库上的评估结果：答案质量达 83%，相比逐文件探索方式减少 10 倍 token 消耗，减少 2.1 倍工具调用次数。

安全与信任 — 本工具会读取你的代码库，并向你的 Agent 配置文件写入内容，这正是它的设计用途。如果你希望在运行前先进行审计，完整源代码在此——每个发布的二进制文件均已签名、校验和，并经 70 余个杀毒引擎扫描。所有处理均在本地完成，你的代码绝不会离开你的机器。发现安全问题？我们希望知晓——请参阅 SECURITY.md。安全是我们的第一优先级。

内置 3D 图谱可视化界面（UI 版本）——在 localhost:9749 探索你的知识图谱

为什么选择 codebase-memory-mcp

• 极速索引 — Linux 内核（2800 万行代码，75K 个文件）仅需 3 分钟。内存优先流水线：LZ4 压缩、内存版 SQLite、融合 Aho-Corasick 模式匹配。索引完成后内存即释放。

• 即插即用 — 适用于 macOS（arm64/amd64）、Linux（arm64/amd64）和 Windows（amd64）的单一静态二进制文件。无需 Docker，无运行时依赖，无需 API 密钥。下载 → install → 重启 Agent → 完成。

• 158 种语言 — tree-sitter 语法文件已预编译进二进制文件。无需额外安装，不会出现兼容性问题。

• 减少 120 倍 token 消耗 — 5 次结构化查询约消耗 3,400 个 token，而逐文件搜索约消耗 412,000 个 token。一次图谱查询可替代数十次 grep/read 操作。

• 11 个 Agent，一条命令 — install 自动检测 Claude Code、Codex CLI、Gemini CLI、Zed、OpenCode、Antigravity、Aider、KiloCode、VS Code、OpenClaw 和 Kiro——为每个 Agent 配置 MCP 条目、指令文件和预工具钩子。

• 内置图谱可视化 — 在 localhost:9749 提供 3D 交互界面（可选 UI 二进制版本）。

• 基础设施即代码索引 — Dockerfile、Kubernetes 清单和 Kustomize 覆盖层作为图谱节点进行索引并建立交叉引用。K8s 类型对应 Resource 节点，Kustomize 覆盖层对应 Module 节点，并通过 IMPORTS 边连接到所引用的资源。

• 14 个 MCP 工具 — 搜索、追踪、架构分析、影响分析、Cypher 查询、死代码检测、跨服务 HTTP 链接、ADR 管理等。

快速开始

一行安装命令（macOS / Linux）：

curl -fsSL https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.sh | bash

含图谱可视化界面：

curl -fsSL https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.sh | bash -s -- --ui

Windows（PowerShell）：

# 1. Download the installer Invoke-WebRequest - Uri https: // raw.githubusercontent.com / DeusData / codebase - memory - mcp / main / install.ps1 - OutFile install.ps1 # 2. (Optional but recommended) Inspect the script notepad install.ps1 # 3. Run it .\install.ps1

选项：--ui（图谱可视化）、--skip-config（仅二进制文件，不配置 Agent）、--dir= （自定义安装路径）。

重启你的编程 Agent。说一句 "Index this project"——完成。

手动安装

• 下载最新版本中适用于你平台的压缩包：codebase-memory-mcp- - .tar.gz（macOS/Linux）或 .zip（Windows）——标准版

• codebase-memory-mcp-ui- - .tar.gz / .zip — 含图谱可视化版本

• 解压并安装（每个压缩包均包含 install.sh 或 install.ps1）：macOS / Linux：tar xzf codebase-memory-mcp- * .tar.gz ./install.sh Windows（PowerShell）：Expand-Archive codebase - memory - mcp - windows - amd64.zip - DestinationPath . .\install.ps1

• 重启你的编程 Agent。

install 命令会自动去除 macOS 隔离属性并对二进制文件进行临时签名——无需手动执行 xattr/codesign。

install 命令会自动检测所有已安装的编程 Agent，并为每个 Agent 配置 MCP 服务器条目、指令文件、技能和预工具钩子。

图谱可视化界面

如果你下载的是 ui 版本：

codebase-memory-mcp --ui=true --port=9749

在浏览器中打开 http://localhost:9749。界面以后台线程方式与 MCP 服务器并行运行——只要你的 Agent 已连接，界面便随时可用。

自动索引

在 MCP 会话启动时启用自动索引：

codebase-memory-mcp config set auto_index true

启用后，新项目在首次连接时会自动进行索引。已索引的项目会注册到后台监视器，持续进行基于 git 的变更检测。可配置文件数量上限：config set auto_index_limit 50000。

保持更新

codebase-memory-mcp update

MCP 服务器还会在启动时检查更新，若有新版本发布，会在首次工具调用时发出通知。

卸载

codebase-memory-mcp uninstall

移除所有 Agent 配置、技能、钩子和指令文件，但不会删除二进制文件或 SQLite 数据库。

功能特性

图谱与分析