这个项目能做什么
codebase-memory-mcp 是一种代码智能引擎,通过 Model Context Protocol (MCP) 为 AI 编码代理提供服务。它将代码库解析为持久知识图谱,包含函数、类、调用链、HTTP 路由以及跨服务链接,然后针对该图谱回答结构化查询。
- 索引:使用 tree-sitter 对 162 种内置语法进行 AST 分析,编译进二进制。采用 RAM 首先的管道,结合 LZ4 压缩、内存中的 SQLite 以及 Aho-Corasick 模式匹配。README 报告索引 Linux 内核(2800 万行代码,75 千文件)大约需要 3 分钟。
- 混合 LSP:轻量级 C 实现的类型解析算法,适用于 Python、TypeScript/JavaScript/JSX/TSX、PHP、C#、Go、C、C++、Java、Kotlin、Rust 和 Perl,覆盖参数绑定、返回类型推断、泛型替换以及语言特定的解析模式。
- 查询界面:提供 15 项 MCP 工具,包括架构概览、调用图追踪、影响分析、死代码检测、类 Cypher 图查询、语义搜索、BM25 全文搜索以及代码搜索。README 报告结构化查询延迟为亚毫秒,相比逐文件探索可显著降低 token 消耗。
- 图模型:边类型包括 CALLS、IMPORTS、DEFINES、IMPLEMENTS、INHERITS、HTTP_CALLS、EMITS、LISTENS_ON、DATA_FLOWS、SIMILAR_TO 和 SEMANTICALLY_RELATED。跨仓库 CROSS_* 边可在同一存储中链接不同仓库的节点。
- 基础设施即代码:Dockerfile、Kubernetes 清单和 Kustomize 叠加层同样被索引为图节点,并建立交叉引用。
- 分发:提供适用于 macOS、Linux 和 Windows 的单一原生可执行文件,无需语言运行时、托管服务或 API 密钥。亦可通过 npm、PyPI、Homebrew、Scoop、Winget、Chocolatey、AUR 和 go install 获得。所有处理均在本地完成。
- 操作:install 命令会自动检测并配置受支持的编码代理。共享协调守护进程管理后台监视器、索引作业以及可选的 UI。可配置自动索引和自动监视。内置 3D 图可视化 UI 在 localhost:9749 提供服务。
- 团队共享:可选的 zstd 压缩 SQLite 快照(.codebase-memory/graph.db.zst)可被提交,使队友从该工件引导启动,随后进行增量索引而非完整重新索引。
该项目不内嵌 LLM;MCP 客户端担任智能层,负责将自然语言问题转换为图查询。README 引用了预印本(arXiv:2603.27277),阐述了设计与基准,并记录了安全实践,包括仅本地处理以及发布制品验证。
评论
0 评分人数达到10人后显示
登录后参与讨论。