CodeGraphContext 是什麼？為何你需要它？

CodeGraphContext 是一款開源的 MCP（Model Context Protocol）伺服器，專門設計用來將本地程式碼自動索引至圖形資料庫（如 Neo4j）。透過這種方式，開發者可以將複雜的程式碼結構轉化為節點與關係的圖形表示，進而更直觀地理解程式碼之間的依賴關係、呼叫鏈和模組架構。

簡單來說，假設你有一個包含數千行程式碼的專案，傳統的搜尋方式很難找出某個函式被哪些地方呼叫。但透過 CodeGraphContext，你可以將整個專案「圖形化」，然後用查詢語句快速找到任意程式碼之間的關聯。

安裝與環境設定教學

開始使用 CodeGraphContext 前，你需要準備以下環境：

  • Node.js：版本 18 以上
  • 圖形資料庫：建議使用 Neo4j Desktop 或 Neo4j Aura 免費版
  • 專案程式碼：你需要分析的程式碼專案

安裝步驟如下：

  1. 透過 npm 安裝 CodeGraphContext：
npm install -g codegraph-context
  1. 設定環境變數連接 Neo4j：
export NEO4J_URI=bolt://localhost:7687
export NEO4J_USER=neo4j
export NEO4J_PASSWORD=your_password


    
  
  1. 初始化專案索引：
    2. 




codegraph-context init /path/to/your/project



執行完成後，你的程式碼將自動被解析並儲存至圖形資料庫中。



Playground 網站上手實驗



CodeGraphContext 最近推出了線上 Playground，讓開發者無需在本機安裝任何環境，就能直接在瀏覽器中體驗圖形資料庫查詢的魅力。



Playground 提供預設的範例專案，你可以直接練習以下常見查詢：



    
  
  • 找出函式的所有呼叫者：
    • 




MATCH (f:Function {name: "calculateTotal"})
CALL f<-[:CALLS]-(caller)
RETURN caller.name



    
  
  • 分析模組依賴關係：
    • 




MATCH (m:Module)-[:IMPORTS]->(dep:Module)
RETURN m.name, collect(dep.name) as dependencies



這個功能特別適合技術探索階段，讓你在正式投入專案前先熟悉圖形查詢語法（Cypher）。



應用場景與實際案例



將程式碼索引至圖形資料庫的應用場景非常廣泛：



    
  
  • 大型重構：在重構前分析程式碼的依賴關係，確保修改不會破壞隱藏的呼叫鏈
    • 
  
  • 技術債分析：找出過度複雜的模組或未被使用的函式
    • 
  
  • 知識傳遞：新團隊成員可透過圖形快速理解程式碼架構
    • 
  
  • 安全審計：追蹤敏感資料在程式碼中的流向
    • 




舉例來說，一家SaaS公司使用 CodeGraphContext 分析其微服務架構後，發現某個「通用工具庫」實際上被20多個服務依賴，這個發現幫助團隊在重構時制定了更謹慎的遷移策略。



結論與下一步建議



CodeGraphContext 為程式碼分析開啟了新的可能性，特別適合中大型專案的維護與優化。建議讀者可以先從 Playground 開始體驗，熟悉基本的圖形查詢語法後，再將工具應用到實際專案中。



如果你使用的是 VS Code 或 Cursor 等支援 MCP 的編輯器，還可以將 CodeGraphContext 直接整合至開發環境中，實現即時的程式碼關係查詢。