DeusData codebase-memory-mcp

codebase-memory-mcp 是面向 AI 编码智能体的最快、最高效的代码智能引擎。平均仓库可在毫秒级完成全索引，Linux 内核（2800 万行代码，7.5 万个文件）仅需 3 分钟。结构查询响应时间低于 1 毫秒。以单一静态二进制文件形式发布，支持 macOS、Linux 和 Windows —— 下载、运行安装、完成。通过 tree-sitter AST 分析实现 158 种语言的高质量解析，并针对 Python、TypeScript / JavaScript / JSX / TSX、PHP、C#、Go、C、C++、Java、Kotlin 和 Rust 增强 Hybrid LSP 语义类型解析 —— 生成包含函数、类、调用链、HTTP 路由和跨服务链接的持久化知识图谱。提供 14 个 MCP 工具。零依赖。支持 11 种编码智能体的即插即用。

研究

本项目的设计和基准测试详见预印本《Codebase-Memory: Tree-Sitter-Based Knowledge Graphs for LLM Code Exploration via MCP》（arXiv:2603.27277）。在 31 个真实仓库上的评估结果：回答质量 83%，Token 消耗减少 10 倍，工具调用次数相比逐文件探索减少 2.1 倍。

安全与信任

本工具会读取你的代码库并写入智能体配置文件。这正是其设计目的。如果你希望在运行前进行审计，完整源代码在此 —— 每个发布版本的二进制文件均经过签名、校验和验证，并由 70 多个反病毒引擎扫描。所有处理 100% 在本地完成；你的代码永远不会离开你的机器。发现安全问题？请告知我们 —— 详见 SECURITY.md。安全是我们的第一要务。

内置 3D 图谱可视化（UI 变体）

在 localhost:9749 探索你的知识图谱

为什么选择 codebase-memory-mcp

极速索引 —— Linux 内核（2800 万行代码，7.5 万个文件）仅需 3 分钟。内存优先管道：LZ4 压缩、内存 SQLite、融合 Aho-Corasick 模式匹配。索引完成后释放内存。
即插即用 —— 单一静态二进制文件，支持 macOS（arm64/amd64）、Linux（arm64/amd64）和 Windows（amd64）。无需 Docker、运行时依赖或 API 密钥。下载 → 安装 → 重启智能体 → 完成。
158 种语言 —— 内置 tree-sitter 语法编译到二进制文件中。无需安装任何内容，永远不会出错。
Token 消耗减少 120 倍 —— 5 个结构查询：约 3,400 Token，而逐文件搜索约 412,000 Token。一个图谱查询替代数十次 grep/read 循环。
11 种智能体，一条命令 —— 安装时自动检测 Claude Code、Codex CLI、Gemini CLI、Zed、OpenCode、Antigravity、Aider、KiloCode、VS Code、OpenClaw 和 Kiro —— 为每种智能体配置 MCP 条目、指令文件和预工具钩子。
内置图谱可视化 —— 在 localhost:9749 提供 3D 交互界面（可选 UI 二进制变体）。
基础设施即代码索引 —— Dockerfile、Kubernetes 清单和 Kustomize 覆盖层作为带有交叉引用的图谱节点进行索引。K8s 类型作为资源节点，Kustomize 覆盖层作为模块节点，通过 IMPORTS 边连接到引用的资源。
14 个 MCP 工具 —— 搜索、追踪、架构、影响分析、Cypher 查询、死代码检测、跨服务 HTTP 链接、ADR 管理等。

快速开始

一行安装（macOS / Linux）：

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

带图谱可视化 UI：

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

Windows（PowerShell）：

# 1. 下载安装程序
Invoke-WebRequest -Uri https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.ps1 -OutFile install.ps1

# 2. （可选但推荐）检查脚本
notepad install.ps1

# 3. 运行
.\install.ps1

选项：--ui（图谱可视化）、--skip-config（仅二进制文件，不设置智能体）、--dir=（自定义位置）。

重启你的编码智能体。说“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

重启你的编码智能体。

安装命令会自动移除 macOS 隔离属性并临时签名二进制文件 —— 无需手动执行 xattr/codesign。安装命令会自动检测所有已安装的编码智能体，并为每种智能体配置 MCP 服务器条目、指令文件、技能和预工具钩子。

图谱可视化 UI

如果你下载了 UI 变体：

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

在浏览器中打开 http://localhost:9749。UI 作为后台线程与 MCP 服务器一起运行 —— 只要你的智能体连接，它就可用。

自动索引

在 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

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

功能

图谱与分析

架构概览：get_architecture 单次调用返回语言、包、入口点、路由、热点、边界、层和集群
架构决策记录：manage_adr 跨会话持久化架构决策
Louvain 社区检测：通过聚类调用边发现功能模块
Git 差异影响映射：detect_changes 将未提交的变更映射到受影响的符号，并附带风险分类
调用图：跨文件解析函数调用