SammySnake-d/fast-context-mcp

AI-driven semantic code search as an MCP tool — powered by Windsurf's reverse-engineered SWE-grep protocol

解決的問題

它讓 AI 客戶端（如 Claude Code、Cursor 或 Claude Desktop）能使用自然語言查詢，在本地程式碼庫中執行語意程式碼搜尋。它彌補了使用者高階問題與相關邏輯實際存放的檔案及行範圍之間的差距，無需使用者手動使用 grep 或瀏覽目錄。

工作原理

此專案作為 Model Context Protocol (MCP) 伺服器，利用 Windsurf 的 Devstral API。當收到查詢時，伺服器會掃描本地專案目錄並產生目錄樹。此上下文與查詢一併傳送至 Devstral 模型，模型隨即產生一系列本地指令（例如 ripgrep、檔案讀取與 glob 搜尋）。這些指令會在使用者的機器上本地執行，結果會反覆回饋給 AI 進行多輪優化，直到識別出最相關的檔案路徑與行範圍為止。

適用對象

使用支援 MCP 的 AI 程式碼助理，並希望以更強大的 AI 驅動方式瀏覽與搜尋本地原始碼，而不依賴基本的關鍵字比對的開發者。

特色

零系統依賴：透過 npm 內建 ripgrep 與 tree，確保在 macOS、Windows 與 Linux 上皆可運作，無需手動安裝。
語意搜尋：使用 AI 模型以迭代方式搜尋並優化結果，而非簡單的字串比對。
自動上下文管理：自動調整目錄樹深度，避免超過傳輸負載上限。
自動偵測憑證：可自動從本地的 Windsurf 或 Devin 安裝中提取 API 金鑰。