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 分