DeusData codebase-memory-mcp

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 增强混合 LSP 语义类型解析 — 生成包含函数、类、调用链、HTTP 路由和跨服务链接的持久化知识图谱。提供 14 个 MCP 工具。零依赖。可在 11 个编码代理中即插即用。

研究

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

安全与信任

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

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

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

为什么选择 codebase-memory-mcp

• 极速索引 — Linux 内核（2800 万行代码，7.5 万个文件）仅需 3 分钟。RAM 优先管道：LZ4 压缩、内存 SQLite、融合 Aho-Corasick 模式匹配。索引完成后释放内存。
• 即插即用 — 单一静态二进制文件，支持 macOS（arm64/amd64）、Linux（arm64/amd64）和 Windows（amd64）。无需 Docker，无需运行时依赖，无需 API 密钥。下载 → 安装 → 重启代理 → 完成。
• 158 种语言 — 内置 tree-sitter 语法，编译进二进制文件。无需安装任何内容，不会出现任何破坏。
• 令牌消耗减少 120 倍 — 5 个结构查询：约 3,400 个令牌，而逐文件搜索约需 412,000 个令牌。一个图谱查询替代数十次 grep/read 循环。
• 11 个代理，一条命令 — 安装脚本自动检测 Claude Code、Codex CLI、Gemini CLI、Zed、OpenCode、Antigravity、Aider、KiloCode、VS Code、OpenClaw 和 Kiro — 为每个代理配置 MCP 条目、指令文件和预工具钩子。
• 内置图谱可视化 — 在 localhost:9749 提供 3D 交互式 UI（可选 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 将未提交的变更映射到受影响的符号，并附带风险分类
• 调用图：跨文件解析函数调用