GlitterKill/sdl-mcp

Symbol Delta Ledger (SDL-MCP) is a policy-centered context budget layer for coding agents: Symbol-graph intelligence combined with precision tools. It turns sprawling codebases into compact, high-signal context that saves tokens, speeds up workflows, and improves agent output.

解決的問題

SDL-MCP 解決了 AI 編碼代理的「上下文預算」問題。它不將整個原始碼檔案輸入 LLM(這會消耗 token 並引入雜訊),而是為代理提供一種結構化方式,使其僅發現並檢索完成特定任務所需的程式碼與元資料。

工作原理

該系統將程式碼庫索引為符號圖。採用一種稱為「鳶尾花門梯」的分層檢索方法,允許代理從緊湊的元資料(符號卡片)逐步升級到骨架、熱路徑,最終取得有界原始碼視窗。它利用 tree-sitter 進行結構分析,並可整合 SCIP 或語言提供方的事實,實現精確的交叉引用。此專案實作了 Model Context Protocol (MCP),透過 stdio 或 HTTP 與 AI 客戶端通訊。

適用對象

專為需要高效導航大型程式碼庫,但又不希望過度佔用模型上下文視窗的 AI 編碼代理開發者或使用者設計。

主要亮點

  • 符號卡片:每個符號的緊湊元資料,使代理無需開啟完整檔案即可開始探索。
  • 圖切片:基於程式碼庫關係與任務範圍檢索子圖,而非單純的目錄邊界。
  • 增量包:分析版本間變更,識別受影響的符號並計算 PR 審查的「影響範圍」。
  • 即時索引:透過即時覆蓋層支援草稿緩衝區更新,實現檔案儲存前的即時上下文更新。
  • 開發記憶:可選儲存與程式碼庫直接關聯的決策記錄與任務筆記。
  • 工具閘道:提供靈活的工具介面(Flat、Gateway 或 Code 模式),以優化向 AI 客戶端暴露的工具數量。

相關

  • 專案
  • 專案
  • 專案
  • Dispatch
  • 專案