Repolode
sverklo

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. 1

    预览证明,不写入项目文件

    npm exec --yes --package=sverklo@latest -- sverklo prove --no-write --guided --markdown
  2. 2

    预览 init 将修改的文件

    sverklo init --dry-run
  3. 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 数据每日更新。

相关项目