contextshrinker 是一个用 Go 编写的零依赖、无头（headless）模型上下文协议（MCP）服务器。它将本地代码库索引到嵌入式 Kùzu 图数据库中，从而大幅减少自主 AI 代理（如 Claude Code、Cursor、Antigravity IDE、Aider 和 Claude Desktop）的 LLM 令牌消耗。
contextshrinker 不会强迫 AI 代理读取原始源文件或运行笨拙的基于 grep 的搜索，而是允许代理查询项目架构依赖关系、函数调用链和类继承结构的语义图——将输入上下文消耗减少 90% 到 98%。
通用代理兼容性： 可通过标准输入/输出（stdio）无缝附加到任何符合 MCP 的编码工具或 IDE。
零外部数据库： 完全自包含。在项目本地的 .contextshrinker/ 目录中运行进程内图数据库（Kùzu）。
自动管理 LSP 守护进程： 自动检测项目语言，以编程方式配置沙盒语言服务器（如用于 Go 的 gopls 或用于 Python 的 pyright）（如果缺失），并在后台查询其 RPC 接口以构建调用图。
多语言支持： 支持 Go、Python、JavaScript、TypeScript 和 Java 的完整 AST 语法解析和语义索引。
干净的项目隔离： 每个工作区都维护自己的 .contextshrinker/ 目录，其中包含隔离的配置文件（.contextshrinker/ignore）和图数据库文件（.contextshrinker/db/）。
实时状态同步： 使用 fsnotify 递归监视文件。保存时，防抖增量更新会清除旧节点并实时重新索引已修改的文件。
交互式图可视化： 按需生成令人惊叹的、由 Vis.js 驱动的深色模式 HTML 代码库可视化（.contextshrinker/contextshrinker_graph.html）。
Related MCP server: code-graph-mcp
为了干净地索引代码，contextshrinker 运行两遍摄取序列：
graph TD
A[Walk Workspace] -->|Filter via .contextshrinker/ignore| B[Pass 1: Tree-sitter Syntax]
B -->|Create Nodes| C[(Kùzu Graph DB)]
C --> D[Pass 2: LSP Semantic Cross-References]
D -->|Create CALLS / IMPLEMENTS Edges| C第一遍（Tree-sitter AST 提取）： 快速扫描源文件以提取实体（函数/方法、类/结构体、变量）及其关联的文档字符串，并将它们作为节点插入。
第二遍（LSP 语义解析）： 查询后台语言服务器协议（LSP）守护进程以获取交叉引用，从而识别和连接调用（CALLS）、导入（IMPORTS）和类继承（IMPLEMENTS / EXTENDS）。
如果您不想安装 Go，可以下载适用于您平台的可移植预编译包：
转到 Releases 页面。
下载适用于您操作系统的存档文件（.tar.gz 或 .zip）。
解压存档。将可执行文件（contextshrinker）及其动态库（libkuzu / kuzu_shared）放在同一文件夹中。
从该目录运行可执行文件：
macOS / Linux：
chmod +x contextshrinker
./contextshrinker --helpWindows：
contextshrinker.exe --helpGo（1.21 或更高版本）
Node.js 和 npm（用于自动安装 JS/TS 和 Python LSP）
克隆存储库并运行：
go build -o contextshrinker要将其直接安装到系统 PATH 中：
go installcontextshrinker 作为编码代理的子进程按需运行。将编译后二进制的绝对路径注册到您的客户端中：
打开 Antigravity IDE。
单击代理面板中的 ...（更多选项） 菜单。
选择 "管理 MCP 服务器" $\rightarrow$ "查看原始配置"。
在 mcp_config.json 中注册服务器：
{
"mcpServers": {
"contextshrinker": {
"command": "/absolute/path/to/contextshrinker"
}
}
}自动添加服务器：
claude mcp add contextshrinker /absolute/path/to/contextshrinker导航到 设置 $\rightarrow$ 功能 $\rightarrow$ MCP。
单击 + 添加新的 MCP 服务器。
设置配置：
名称： contextshrinker
类型： command
命令： /absolute/path/to/contextshrinker
将其添加到 ~/Library/Application Support/Claude/claude_desktop_config.json：
{
"mcpServers": {
"contextshrinker": {
"command": "/absolute/path/to/contextshrinker"
}
}
}配置完成后，以下工具将自动可供您的 AI 编码代理使用：
search_codebase
参数： query（字符串）
描述： 执行全文搜索和 Cypher 查询，以匹配类、函数和变量中的结构和文档字符串。
get_call_chain
参数： target_function（字符串）、depth（整数，最大 5）
描述： 使用变长路径 Cypher 查询解析上游调用者链，以映射调用依赖关系。
get_file_structure
参数： file_path（字符串）
描述： 检索单个文件中包含的完整抽象节点结构（类、接口、方法、变量），而无需将原始文本内容馈送到上下文中。
visualize_codebase
描述： 触发按需 HTML 导出，将 contextshrinker_graph.html 保存到您的 .contextshrinker/ 目录中。
get_architecture_report
描述： 检索完整的代码库架构健康报告，其中包含有关上帝对象、耦合热点、循环、死未导出函数、AI 指标（SCR、DCR、BVI、AOI、调用链深度指数 - CDI）的指标，以及可操作的代码质量指南（Jeff Dean 原则）和 AI 系统提示指令。
您可以使用 contextshrinker 系统地审计耦合、分析领域边界（DDD），并使用 LLM 指导代码重构（例如，将单体应用拆分为模块）。
生成架构指标和指南： 在终端中运行分析命令以检查代码库图并生成报告：
./contextshrinker analyze这将生成 contextshrinker-report.md，其中包含上帝对象（高出站耦合）、黑洞（高入站调用）、循环导入路径、死代码（未使用的私有函数）、AI 指标（包括调用链深度指数 - CDI）以及可操作的代码质量和 LLM 架构指南（Jeff Dean 原则）的指标。
获取系统提示： 从 CLI 检索首席系统架构师提示：
./contextshrinker prompt architect使用 LLM 分析：
将 prompt architect 命令的输出设置为 LLM 的系统提示。
将生成的 contextshrinker-report.md 的内容作为上下文/输入提供。
要求 LLM 提出有界上下文拆分或接口边界。
代理/工具使用工作流： 如果使用兼容 MCP 的代理（如 Antigravity IDE、Claude Code 或 Cursor），您可以直接询问：
"运行 contextshrinker 分析报告，读取生成的 markdown，并充当系统架构师来审计我们的设计热点。在建议具体的模块提取之前，使用
get_call_chain和get_file_structure工具检查耦合情况。"
为防止工作区图膨胀，默认会忽略标准库和依赖项文件夹（node_modules/、vendor/、.git/ 等）。
要添加自定义忽略项，请初始化项目并在工作区根目录生成 .csignore 文件，方法是运行：
contextshrinker init.csignore 中的每一行都会递归匹配：
# Custom project ignores
*.log
tmp-output/
dist/
.vitepress如果您在中小型项目（例如，数百或数千个文件）上使用 contextshrinker，则直接在 LLM/代理提示（如 Claude Code 或 Cursor）中运行初始代码库摄取可能会导致代理超时问题。这是因为代理在等待首次工作区解析和 LSP 引用解析完成时具有严格的超时限制（通常为 60 秒）。
为防止这种情况，请在启动代理之前在终端中遵循以下优化工作流：
初始化工作区： 运行初始化命令以创建配置目录和默认忽略列表：
contextshrinker init配置忽略项：
打开工作区根目录下生成的 .csignore 文件，并添加要排除的任何大型目录（例如，文档站点、测试资产、构建文件夹）。
离线构建数据库： 从终端运行一次分析命令以构建初始图数据库：
contextshrinker analyze这将在离线状态下执行 Tree-sitter 解析和 LSP 语义交叉引用的繁重工作。填充数据库后，后续的代理请求和实时状态同步将在几秒钟内以增量方式运行，从而防止任何将来的超时！
您可以直接从终端查询代码库图、显式启动 MCP 服务器守护进程、检索系统架构师提示或生成健康分析报告。
默认情况下，运行不带参数的 ./contextshrinker 将启动 MCP 服务器守护进程。您也可以显式触发它：
./contextshrinker start分析代码库结构（上帝对象、入站调用热点、循环导入、死代码、调用链深度指数 - CDI 和 LLM 代码质量指南）并将报告写入 contextshrinker-report.md：
./contextshrinker analyze将领域驱动设计（DDD）首席系统架构师系统提示打印到标准输出：
./contextshrinker prompt architect查找与查询匹配的函数、类或变量：
./contextshrinker search "IngestWorkspace"跟踪目标函数名称的上游调用者（默认深度为 3，最大为 5）：
./contextshrinker call-chain "IngestWorkspace" --depth 3获取文件的结构，而无需读取其完整文本内容：
./contextshrinker structure "main.go"生成 Vis.js 代码库图表示：
./contextshrinker visualize在任何浏览器中打开生成的 .contextshrinker/contextshrinker_graph.html，以交互方式浏览项目的架构。
--workspace <path>：指定项目目录（默认为 .）。
--db <path>：指定数据库存储目录（默认为 .contextshrinker/db）。
--reindex：在执行查询之前强制进行完整的工作区摄取扫描（重新解析代码和映射 LSP 关系）。如果数据库为空，则会自动运行摄取。
注意： 由于 Kuzu DB 会建立独占的文件级锁，请确保在活动数据库上运行 CLI 命令时暂停或停止 IDE 的 MCP 客户端，或者使用 CLI 标志指定其他工作区/数据库目录。
本项目根据 MIT 许可证授权。
This server cannot be deployed
Repository knowledge graph MCP server for codebase understanding and debugging.
Hosted code graph over MCP: exact callers, dependencies, and cross-repo blast radius for AI agents.
Enterprise code intelligence for M&A, security audits, and tech debt. Hosted server with 200k free.
Codebase graphs, caller impact analysis, and recorded project context for AI coding agents.
