Spiderbrain

ai.spiderbrain由 spiderbrain.ai 发布官方发布者v0.2.3更新于 Oct 27, 2026

Deterministic context layer for your codebase: change impact, blast radius, answers with receipts.

已验证Streamable HTTP可网页运行知识与记忆开发者工具

概览

AI 生成的概览

为代码仓库提供已提交、不含源码的理解层，让助手追踪变更影响、影响范围与文件路径，并附上依据。

可以做什么
  • 查询仓库已提交的理解层，了解某处改动会波及什么，包括指定文件或当前 git diff 的影响范围。
  • 找出关键承重文件，并追踪一个文件如何到达另一个文件。
  • 校验理解层文件夹是否被篡改，可用作 CI 关卡。
  • 在配置了 API 密钥时，可选地向云端 why 层询问代码背后的设计缘由。
  • 仓库没有已提交的理解层时，回退到公共注册表查询。
适用场景
适合助手在已有已提交理解层的代码库上工作，需要判断变更影响、依赖关系或设计缘由，而不只是读文件。也适合在 CI 中校验该文件夹是否完整。
运行要求
可作为远程端点运行，也可通过 npx 在本地运行（需 Node.js）。必须把 SPIDERBRAIN_ROOT 设为包含已提交理解层文件夹的仓库绝对路径。支持 OAuth 的客户端可直接连接；否则需 Authorization 头或 SPIDERBRAIN_API_KEY 变量才能使用云端 why 层。SPIDERBRAIN_REGISTRY 可覆盖公共注册表地址。
安装前请注意
SPIDERBRAIN_API_KEY 是用于云端 why 层的密钥，会发送给厂商服务；结构性工具无需它即可使用。若未设置 SPIDERBRAIN_ROOT，服务器会静默地服务错误目录并报告未找到理解层，而不是报错。生成理解层文件夹会向仓库写入文件，并需要账号与密钥。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Spiderbrain，将其添加到工作区。
  2. 连接 所需的 凭据。它们会被私密存储，绝不会在公开页面上展示。
  3. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/ai.spiderbrain%2Fspiderbrain/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。 客户端会在首次连接时完成 OAuth 登录。

{
  "mcpServers": {
    "spiderbrain": {
      "type": "http",
      "url": "https://mcp.spiderbrain.ai/mcp"
    }
  }
}

README

spiderbrain

A committed understanding layer for your repo, and the one command to work with it. A repo tells an AI agent what the code is; it never tells it what matters, what a change reaches, or why anything was built the way it was. spiderbrain fixes that.

Give a repo understanding

export SPIDERBRAIN_API_KEY=sb_live_...     # https://spiderbrain.ai/dashboard?tab=keysnpx spiderbrain create

Writes a source-free .spiderbrain/ folder and an AGENTS.md block. Commit both.

Read a repo's understanding (no account needed)

When a repo has a .spiderbrain/ folder, any agent or developer can use it offline:

npx spiderbrain mcp --root .        # an MCP server for Claude Code / Cursornpx spiderbrain blast src/db.ts     # what a change here reachesnpx spiderbrain impact              # what your current git diff reachesnpx spiderbrain keystones           # the load-bearing filesnpx spiderbrain path a.ts b.ts      # how one file reaches anothernpx spiderbrain verify --allow-stale   # folder untampered? (CI gate)

An MCP client's working directory is usually not your repository, so pass the repo explicitly with --root <path>, --root=<path>, or the SPIDERBRAIN_ROOT environment variable. Without it the server serves the working directory and reports that no understanding layer was found, which is a wrong answer rather than an error.

Every command takes --json (exit codes: 0 ok, 1 failed, 2 usage, 3 no understanding). No committed folder? The reader falls back to the public registry when the repo's origin has an unofficial brain there.

The pieces

spiderbrain is a thin dispatcher over two independently installable packages:

A CI job that only publishes understanding can depend on @spiderbrain/create alone; an MCP config that only reads can point at @spiderbrain/read. spiderbrain is what you type when you just want the thing.

License

MIT.

来源：spiderbrain/README.md，提交 6e8b121

工具

0
该服务器需要登录，因此 SourceWeft 无法在没有账号的情况下读取其工具，也未收录。已连接账号所能看到的内容可能因账号及其权限而异。

版本历史

1
  1. v0.2.3最新Sep 16, 2026

评分

已满足适用检查项的 85%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分