自托管的代码上下文工具,统一索引多个代码托管平台的仓库,供开发者和 AI 智能体搜索与浏览。
sverklo/sverklo
本地优先的 MCP 服务器,为编码智能体提供代码仓库记忆,包括符号图、调用关系、影响范围分析和基于 git 的决策记录。
- Star
- 82
- Fork
- 11
- 未关闭 Issue
- 3
- 最近提交
- 3个月前
这是什么?
Sverklo 是一个 MCP 服务器,让 Claude Code、Cursor、Windsurf、Codex CLI 等 AI 编码智能体在修改代码前先获得仓库的结构化视图。它会索引符号、引用和导入关系,智能体可以查询某个函数的调用方、某个模块依赖的文件,并评估改动的影响范围,而不只依赖文本搜索。
索引在本地嵌入式 SQLite 中完成,默认使用内置的 ONNX 向量模型。检索结合全文匹配、向量相似度,以及基于依赖图的 PageRank 排序。团队的设计决策和代码模式可以保存为绑定 git 提交的记忆,便于回溯某个历史时间点的认知。只有显式配置时才会使用远程 embedding 服务。
项目还提供基于 diff 的风险评估审查、可在提交前运行的循环依赖检查,以及可自动为支持的编辑器写入 MCP 配置的 `sverklo init` 命令。部分语言使用 tree-sitter 解析,其他语言则回退到正则解析。
核心功能
- 01包含调用方、引用和导入依赖的符号图
- 02结合全文检索、向量相似度和 PageRank 的混合搜索
- 03编辑前分析重构的影响范围
- 04对 git diff 进行风险评分并映射测试覆盖
- 05绑定 git 提交的记忆,用于跨提交记录决策
- 06默认本地索引,无需 API 密钥
适用场景
- 在 Claude Code 或 Cursor 重命名函数前先检查所有调用方
- 审查大型 PR,快速找出风险最高的文件
- 记录架构决策,让智能体在后续会话中遵循
- 在提交前运行检查,阻止新引入的循环依赖
快速上手
- 1
预览证明,不写入项目文件
npm exec --yes --package=sverklo@latest -- sverklo prove --no-write --guided --markdown - 2
预览 init 将修改的文件
sverklo init --dry-run - 3
全局安装并为你的编码代理初始化
npm install -g sverklo && sverklo init
使用前须知
- 显式配置远程嵌入提供商时,代码片段会发送给该提供商。
- 内置嵌入模型(约 86 MB)首次使用时需从 HuggingFace 下载。
收录于专题
标签
常见问题
- sverklo 是什么?
- 本地优先的 MCP 服务器,为编码智能体提供代码仓库记忆,包括符号图、调用关系、影响范围分析和基于 git 的决策记录。 Sverklo 是一个 MCP 服务器,让 Claude Code、Cursor、Windsurf、Codex CLI 等 AI 编码智能体在修改代码前先获得仓库的结构化视图。它会索引符号、引用和导入关系,智能体可以查询某个函数的调用方、某个模块依赖的文件,并评估改动的影响范围,而不只依赖文本搜索。
- sverklo 可以免费使用吗?用的什么许可证?
- sverklo 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
- sverklo 还在维护吗?
- 半年内有更新。sverklo 最近一次提交是在 2026年8月12日。
- sverklo 适合用来做什么?
- 在 Claude Code 或 Cursor 重命名函数前先检查所有调用方 审查大型 PR,快速找出风险最高的文件 记录架构决策,让智能体在后续会话中遵循 在提交前运行检查,阻止新引入的循环依赖
- sverklo 怎么安装和运行?
- 预览证明,不写入项目文件: npm exec --yes --package=sverklo@latest -- sverklo prove --no-write --guided --markdown 预览 init 将修改的文件: sverklo init --dry-run 全局安装并为你的编码代理初始化: npm install -g sverklo && sverklo init
- 在哪里获取 sverklo?
- 源代码和安装说明在 GitHub 上:https://github.com/sverklo/sverklo
概要由 AI 根据项目 README 生成;GitHub 数据每日更新。
相关项目
本地代码智能引擎,将多个代码仓库索引为知识图谱,通过 CLI、MCP 服务与 API 提供给 AI 编程助手和 IDE。
本地优先的共享项目记忆层,让 Claude Code、Codex、Cursor 等编程智能体通过 MCP 读写同一份项目记忆。
让 Codex、Claude Code、Cursor、Hermes Agent 和 OpenClaw 共享一份加密的本地记忆,互相交接任务和审查代码。
面向 AI 智能体的长期记忆运行时,以 Markdown 文件为唯一事实来源,本地检索,可在 Claude Code、Codex 等工具间共享,无需 API Key。
面向编程智能体的长期记忆层,基于本地 SQLite 存储,可在 Claude Code、Codex、Cursor 等工具间共享。