SuperAPI AI 工具集

mcp-injector

mcp-injector 是一个本地 MCP 守护进程,可在将代码库发送给 Claude 等 AI 编程助手前进行压缩。它通过预索引整个代码库到本地 SQLite 目录,并结合 AST 函数体折叠与确定性输出,将代码库转换为轻量、缓存友好的载荷,从而减少 41-89% 的 token 消耗,最高可降低 90% 的 API 成本,并避免上下文窗口溢出。所有处理均在本地完成,无云端、无遥测,并内置密钥自动脱敏功能。

访问官网

工具介绍

mcp-injector 是一个本地 MCP 守护进程,用于在将代码库发送给 Claude 等 AI 编程助手之前对其进行压缩。它通过预索引整个代码库到本地 SQLite 目录,并结合 AST 函数体折叠与确定性输出,将大型代码库转换为轻量、缓存友好的载荷,从而减少 41-89% 的 token 消耗,最高可降低 90% 的 API 成本,并避免上下文窗口溢出。所有处理均在本地完成,无云端、无遥测。

主要能力

  • 代码压缩与索引:使用单遍 AST 解析器扫描仓库,识别接口、类和函数签名,构建符号图和依赖图,并持久化到本地 SQLite FTS5 目录。索引在文件变更时增量更新,AI 提示期间零开销。
  • MCP 工具集:提供多个工具供 AI 代理调用,包括:
    • get_project_map:返回压缩的工作区结构概览,函数体被折叠替换为占位符。支持压缩层级、指定未折叠文件、路径前缀范围限定,并始终包含 Git 上下文和密钥脱敏计数。
    • injector_retrieve:从本地缓存检索文件的完整未压缩源代码,支持按行范围检索和展开跨文件依赖。
    • injector_search:基于 BM25 的全文符号搜索,支持 FTS5 布尔逻辑。
    • injector_diagram:为给定符号生成 Mermaid 序列图,遍历出站依赖。
    • injector_regex_search:针对文件内容的精确字面量或正则搜索回退。
    • injector_write_file:将完整文件写入磁盘,并拦截包含压缩折叠标记的载荷以防止数据丢失。
    • injector_blast_radius:分析更改符号的架构影响,支持入站和出站方向遍历。
    • injector_git_context:集成本地 Git 历史,提供提交上下文、作者和代码演变信息。
    • injector_inspect_table:数据库内省,目前支持 PostgreSQL 和 MySQL,需设置 FOLDWORK_DB_DSN 环境变量。
    • injector_clear_cache:清除 SQLite 索引缓存并触发冷启动全量重新索引。
    • injector_stats:返回索引状态、压缩比、索引文件总数和缓存命中率。
    • injector_sync(已弃用):读工具会自动等待待处理的索引,无需手动调用。
  • 安全与脱敏:内置 Shannon 熵过滤器,实时分析所有 AST 字符串和注释,自动脱敏高熵字符串(如 AWS 访问密钥、SSH 私钥、数据库密码)、JWT 令牌、私有密钥头等。脱敏在本地压缩前进行,始终开启且不可禁用。Pro 许可证验证使用离线 Ed25519 加密,守护进程从不发起出站网络请求。
  • 分支感知与确定性:切换分支时通过 git 钩子自动触发增量重新索引。保证跨运行输出字节一致,以最大化 Claude 的 KV 提示缓存命中。
  • 支持语言:Go、Python、TypeScript、JavaScript、Java、C++、C、C#、Rust。

使用方式

  1. 检查免费资格:在项目上运行基准测试 CLI,查看 token 节省和代码行数。若项目少于 50,000 行,mcp-injector 完全免费。
  2. 安装守护进程:安装程序自动检测 Claude Desktop、Cursor、VS Code、Devin Desktop 和 Antigravity,并自动写入 MCP 配置。
  3. 重启 IDE:MCP 服务器随 IDE 启动自动运行,无需单独管理守护进程。
  4. 验证:在 Claude Code 或 Cursor 中要求 Claude 使用 get_project_map 显示项目结构。
  5. 获取完整源码:当 Claude 需要查看压缩函数的完整实现时,会自动调用 injector_retrieve,也可显式触发。
  6. 编辑代码:必须使用 injector_write_file 工具编辑代码,防止折叠占位符写回源码。
  7. 查看节省:运行 mcp-injector status 或要求 Claude 调用 injector_stats。

手动配置 MCP 时,可将配置添加到对应 IDE 的 MCP 配置文件中。注意 VS Code 支持 ${workspaceFolder},但 Claude Desktop、Cursor 和 Devin Desktop 需要硬编码绝对路径。

适用场景

  • 在大型代码库或企业级 monorepo 中减少 AI 上下文窗口溢出和 API 成本。
  • 追踪认证流程、查找死代码、生成架构图、理解依赖图、定位实现、安全重构、审查拉取请求、导航大型 monorepo。
  • 需要在不泄露敏感凭证的情况下使用 AI 编程助手。

限制

  • 免费层仅适用于总源代码行数少于 50,000 行的工作区。
  • Pro 层($12/月或 $99/年)解锁无限工作区大小和高速增量差异索引。
  • 源代码不公开,为商业软件。
  • 支持的语言有限,具体列表见上。
  • 数据库内省工具目前仅支持 PostgreSQL 和 MySQL。
  • 部分工具需要特定环境变量或配置。

支持联系:foldwork@proton.me