給 Claude Desktop 使用者

Claude Desktop 看不到你的程式碼庫。給它一個。

很多人會在 Claude Desktop 裡詢問自己此刻沒在編輯的程式碼：程式碼審查、新人到職、事故電話會議。Maguyva 為程式碼庫建立索引並透過 MCP 提供，所以答案引用的是檔案和行號，而不是記憶。

Free 方案：3 個儲存庫, 最多索引 5 萬行儲存庫程式碼，免信用卡。

不必簽出程式碼。直接問索引。

關於 Claude Desktop 你需要知道的

四項 Claude Desktop 專屬事實。

// 設定檔

claude_desktop_config.json

從 Settings → Developer → Edit Config 開啟。在 macOS 上位於 ~/Library/Application Support/Claude/；在 Windows 上位於 %APPDATA%\Claude\。

// 傳輸方式

本機橋接

這個檔案用來啟動本機程序，所以本指南透過 npx 執行 @maguyva/mcp。必須安裝 Node.js。

// 金鑰

一筆 env 項目

橋接程式從同一個檔案中伺服器的 env 區塊讀取 MAGUYVA_API_KEY。

// 重新啟動

結束，再重新開啟

Claude Desktop 在啟動時讀取這個檔案。編輯後請完全結束應用程式；伺服器會在下次啟動時執行。

專案指示定下基調，儘管用。

Claude 的專案功能可以存放指示和檔案，專案裡的每段對話一開始就會帶上它們。適合放進去的有：

答案寫給誰看：審查者、新同事、值班工程師。
解說與摘要的內部風格。
幾份你希望被引用的文件，例如架構總覽。

上傳的檔案只是快照。你上傳後的隔天，程式碼庫就已經往前走了。

貼上程式碼不夠用的地方

少了程式碼本身，關於程式碼的對話會出錯的三種情況。

// 貼上的片段會過時

上週貼進對話的檔案，描述的是上週的程式碼。Claude 會依據拿到的那個版本，信心滿滿地回答。

// 片段不是整個系統

單一檔案很少能回答“這裡失敗了會發生什麼事？”處理常式、重試和警示通常分散在三個不同的套件裡。

// 沒有簽出，就沒有 grep

Claude Desktop 沒有你程式碼庫的工作副本。沒有工具的話，關於結構的每個答案，都取決於你記得貼了什麼。

作為 Claude Desktop 中 MCP 伺服器的 Maguyva

一筆 mcpServers 項目讓 Claude 獲得：

針對已索引程式碼庫的 11 個工具 語意、結構（AST）、圖譜與文字搜尋，外加符號查找、依賴方與檔案擷取。
附檔案路徑與行號的答案 涵蓋 285+ 種語言，每個說法你都能查證。
感知分支的結果 讓 Claude 回答你指定的分支，而不是上個月某人上傳的檔案。

專案指示告訴 Claude 怎麼回答。
Maguyva 給 Claude 作答所依據的程式碼。

兩種工作流程

那些你原本得開 IDE 才能回答的問題。

// workflow 01

在審查時解說一條程式碼路徑

claude> 付款 Webhook 的簽章檢查失敗後會發生什麼事？

semantic_search("webhook signature verification failure")
  src/payments/webhooks.ts:64   verifySignature()
  src/payments/webhooks.ts:91   rejectAndAlert()

→ Claude 回答時引用了這兩行。
[exit 0]

答案的每一步都指向一個你能開啟的檔案和行號。

// workflow 02

規劃前先估算變更規模

claude> 有幾個地方在讀舊的 plan_code 欄位？

text_pattern_search("plan_code")
  9 個檔案中有 14 筆符合
dependency_search("getPlanCode", dependents)
  6 個呼叫端

→ 估算從一個數字出發，而不是靠猜。
[exit 0]

在沒人開著程式碼庫的規劃會議上很好用。

在 Claude Desktop 中設定

三個步驟。Free 方案：3 個儲存庫, 最多索引 5 萬行儲存庫程式碼，免信用卡。

// step 01

在 maguyva.ai 索引一個程式碼庫

挑一個你已經熟悉的，這樣你才能評分答案。

// step 02

把 Maguyva 加進 claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "maguyva": {
      "command": "npx",
      "args": [
        "-y",
        "@maguyva/mcp"
      ],
      "env": {
        "MAGUYVA_API_KEY": "mgv_xxxx"
      }
    }
  }
}

// step 03

替換預留位置、重新啟動，然後問一個問題

把 mgv_xxxx 換成你的 API 金鑰，完全結束 Claude Desktop 再重新開啟。如果伺服器沒有出現，請查看 Claude 記錄檔資料夾（macOS 上為 ~/Library/Logs/Claude）中的 mcp-server-maguyva.log。