/ 目錄 / 演練場 / Tree-sitter MCP
● 社群 wrale ⚡ 即開即用

Tree-sitter MCP

作者 wrale · wrale/mcp-server-tree-sitter

將 Tree-sitter 作為 MCP——讓 Claude 具備 AST 層級的存取能力,讓它編輯一個函式,而不是 47 個隨機的正則匹配。

tree-sitter-mcp 將 Tree-sitter 解析器包裝為 MCP 工具。取代讓 Claude 用 grep 搜尋程式碼的方式,改為提供 get_functionlist_symbolsfind_calls。代理可以在 AST 層級進行精準編輯:「只重新命名函式定義,而不是碰巧匹配的字串字面值。」

為什麼要用

核心特性

即時演示

實際使用效果

tree-sitter-mcp.replay ▶ 就緒
0/0

安裝

選擇你的客戶端

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "tree-sitter-mcp": {
      "command": "uvx",
      "args": [
        "mcp-server-tree-sitter"
      ]
    }
  }
}

開啟 Claude Desktop → Settings → Developer → Edit Config。儲存後重啟應用。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "tree-sitter-mcp": {
      "command": "uvx",
      "args": [
        "mcp-server-tree-sitter"
      ]
    }
  }
}

Cursor 使用與 Claude Desktop 相同的 mcpServers 格式。專案級設定優先於全域。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "tree-sitter-mcp": {
      "command": "uvx",
      "args": [
        "mcp-server-tree-sitter"
      ]
    }
  }
}

點擊 Cline 側欄中的 MCP Servers 圖示,然後選 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "tree-sitter-mcp": {
      "command": "uvx",
      "args": [
        "mcp-server-tree-sitter"
      ]
    }
  }
}

格式與 Claude Desktop 相同。重啟 Windsurf 生效。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "tree-sitter-mcp",
      "command": "uvx",
      "args": [
        "mcp-server-tree-sitter"
      ]
    }
  ]
}

Continue 使用伺服器物件陣列,而非映射。

~/.config/zed/settings.json
{
  "context_servers": {
    "tree-sitter-mcp": {
      "command": {
        "path": "uvx",
        "args": [
          "mcp-server-tree-sitter"
        ]
      }
    }
  }
}

加入 context_servers。Zed 儲存後熱重載。

claude mcp add tree-sitter-mcp -- uvx mcp-server-tree-sitter

一行命令搞定。用 claude mcp list 驗證,claude mcp remove 移除。

使用場景

實戰用法: Tree-sitter MCP

重新命名函式,而不影響碰巧匹配的字串

👤 執行重構的開發者 ⏱ ~15 min intermediate

何時使用: 你想將 validateToken 改名為 verifyToken,但不想同時改到文件字串裡說「this validates token」的地方。

步驟
  1. 找到定義
    使用 tree-sitter MCP。找到 validateToken 的定義——只找函式,忽略字串和注解。✓ 已複製
    → 帶有 file:line 和節點類型 'function_definition' 的 AST 節點
  2. 找到參照
    找出所有 validateToken 的呼叫點——只找識別符號解析匹配。✓ 已複製
    → 參照列表,字串中無偽陽性
  3. 重新命名
    在所有真實參照的地方重新命名為 verifyToken。顯示 diff。✓ 已複製
    → 只改動識別符號位置的 N 個重新命名的 diff

結果: 乾淨的重新命名,不碰注解、字串或文件。

注意事項
  • 動態分派/反射會遺漏 — 結合 semble 對動態使用進行語義召回
搭配使用: filesystem · semble-mcp

為提取方法的重構取出函式的精確本體

👤 整理長函式的工程師 ⏱ ~20 min intermediate

何時使用: 你想將一個函式的第 42–87 行精準提取為 helper。

步驟
  1. 切取
    顯示 handler.py 第 42 行 for 迴圈的精確 AST 節點。✓ 已複製
    → 帶有位元組範圍的迴圈節點
  2. 提取
    將該迴圈移入新函式 process_batch。以呼叫取代原始位置。✓ 已複製
    → 重構 diff 保留原始縮排和作用域

結果: 第一次就能順利編譯的重構。

注意事項
  • 被捕獲的變數未提升為引數 — 提取前先請 Claude 列舉自由變數

計算每個檔案的複雜度指標

👤 工程主管/技術債審查 ⏱ ~25 min intermediate

何時使用: 你需要一份複雜程式碼的熱點地圖。

步驟
  1. 遍歷
    對 src/ 下的每個 .py 檔案,使用 AST 計算函式定義數量和概略的循環複雜度。✓ 已複製
    → 每個檔案的表格
  2. 排名
    列出最複雜的前 10 個函式——回報 file、行號、名稱、分數。✓ 已複製
    → 已排名的熱點列表

結果: 優先排序的重構 backlog。

注意事項
  • 循環複雜度 ≠ 可讀性 — 結合審閱者判斷;指標只是起點

組合

與其他 MCP 搭配,撬動十倍槓桿

tree-sitter-mcp + semble-mcp

語義召回(semble)+ 結構精準(tree-sitter)

用 semble 找出可能的呼叫點,再用 tree-sitter 驗證每個是否為真正的識別符號。✓ 已複製
tree-sitter-mcp + filesystem

只讀取 AST 衍生的範圍

用 tree-sitter 取得函式範圍,再用 filesystem 傾印精確的位元組。✓ 已複製

工具

此 MCP 暴露的能力

工具輸入參數何時呼叫成本
parse_file path 取得檔案的完整 AST 免費
list_symbols path, kind? 最上層的清單 免費
find_definition name, scope? 定位某個東西定義的位置 免費
find_references name 找出呼叫點以進行安全重新命名 免費
get_node path, byte_range or line_range 切取精確節點以進行重構 免費

成本與限制

運行它的成本

API 配額
無——本機
每次呼叫 Token 數
100–1500
費用
免費
提示
切取節點,不要傾印整個檔案

安全

權限、密鑰、影響範圍

最小權限: 本機檔案讀取
憑證儲存:
資料出站:

故障排查

常見錯誤與修復

語言不受支援

新增對應的 Tree-sitter 文法;查看 README 中的支援列表

部分檔案解析錯誤

Tree-sitter 會嘗試恢復但標記 ERROR 節點;忽略或修正語法

第一次執行很慢

文法編譯只需一次;後續執行很快

替代方案

Tree-sitter MCP 對比其他方案

替代方案何時用它替代權衡
ast-grep你想要以 CLI 為主的結構性搜尋替換工具整合為 MCP 的程度較低
語言伺服器(LSP)你需要完整的型別解析,而非只是語法設置較重;每種語言需要一個伺服器

更多

資源

📖 閱讀 GitHub 上的官方 README

🐙 查看未解決的 issue

🔍 瀏覽全部 400+ MCP 伺服器和 Skills