Tree-sitter MCP — Anwendungsfälle, Installieren & Live-Demo

Warum nutzen

Hauptfunktionen

Tree-sitter im Hintergrund — 30+ Sprach-Grammatiken
Symbol-bewusste Navigation: Definitionen, Referenzen, Aufrufer
Exakte AST-Knoten aufteilen (Funktion, Klasse, Methode)
Vermeidet die Regex-Fallstricke, in die grep-basierte Agents tappen
Lokal — keine Model-Aufrufe, nur Parsing

Live-Demo

In der Praxis

tree-sitter-mcp.replay ▶ bereit

0/0

Installieren

Wählen Sie Ihren Client

~/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"
      ]
    }
  }
}

Öffne Claude Desktop → Settings → Developer → Edit Config. Nach dem Speichern neu starten.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "tree-sitter-mcp": {
      "command": "uvx",
      "args": [
        "mcp-server-tree-sitter"
      ]
    }
  }
}

Cursor nutzt das gleiche mcpServers-Schema wie Claude Desktop. Projektkonfiguration schlägt die globale.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "tree-sitter-mcp": {
      "command": "uvx",
      "args": [
        "mcp-server-tree-sitter"
      ]
    }
  }
}

Klicken Sie auf das MCP-Servers-Symbol in der Cline-Seitenleiste, dann "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "tree-sitter-mcp": {
      "command": "uvx",
      "args": [
        "mcp-server-tree-sitter"
      ]
    }
  }
}

Gleiche Struktur wie Claude Desktop. Windsurf neu starten zum Übernehmen.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "tree-sitter-mcp",
      "command": "uvx",
      "args": [
        "mcp-server-tree-sitter"
      ]
    }
  ]
}

Continue nutzt ein Array von Serverobjekten statt einer Map.

~/.config/zed/settings.json

{
  "context_servers": {
    "tree-sitter-mcp": {
      "command": {
        "path": "uvx",
        "args": [
          "mcp-server-tree-sitter"
        ]
      }
    }
  }
}

In context_servers hinzufügen. Zed lädt beim Speichern neu.

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

Einzeiler. Prüfen mit claude mcp list. Entfernen mit claude mcp remove.

Anwendungsfälle

Praxisnahe Nutzung: Tree-sitter MCP

Eine Funktion umbenennen ohne ein zufällig passendes String-Literal umzubenennen

👤 Devs beim Refactoring ⏱ ~15 min intermediate

Wann einsetzen: Du willst validateToken → verifyToken umbenennen und nicht auch den Docstring umbenennen, der 'validiert token' sagt.

Ablauf

Definition finden

Use tree-sitter MCP. Find the definition of validateToken — function only, ignore strings and comments.✓ Kopiert

→ AST-Knoten mit Datei:Zeile und Knotentyp 'function_definition'
Referenzen finden

Find all call sites of validateToken — only identifier-resolution matches.✓ Kopiert

→ Referenzliste, keine False Positives in Strings
Umbenennen

Rename to verifyToken everywhere it's a real reference. Show me the diff.✓ Kopiert

→ Diff mit N Umbenennungen nur an Identifier-Positionen

Ergebnis: Sauberes Rename, das Kommentare, Strings und Docs nicht anfasst.

Fallstricke

Dynamisches Dispatch / Reflection wird übersehen — Mit semble für semantischen Recall bei dynamischen Verwendungen kombinieren

Kombinieren mit: filesystem · semble-mcp

Den exakten Funktionskörper für ein Extract-Method-Refactoring extrahieren

👤 Ingenieure, die lange Funktionen aufräumen ⏱ ~20 min intermediate

Wann einsetzen: Du willst Zeilen 42–87 einer Funktion chirurgisch in einen Helper auslagern.

Ablauf

Aufteilen

Show me the exact AST node for the for-loop at line 42 in handler.py.✓ Kopiert

→ Loop-Knoten mit Byte-Bereichen
Extrahieren

Move that loop into a new function process_batch. Replace original with a call.✓ Kopiert

→ Refactoring-Diff respektiert Originaleinrückung und Scope

Ergebnis: Refactoring, das beim ersten Versuch kompiliert.

Fallstricke

Erfasste Variablen werden nicht zu Argumenten gemacht — Claude bitten, freie Variablen aufzuzählen vor dem Extrahieren

Per-Datei-Komplexitätsmetriken berechnen

👤 Engineering-Manager / Tech-Debt-Audits ⏱ ~25 min intermediate

Wann einsetzen: Du brauchst eine Hotspot-Map von komplexem Code.

Ablauf

Durchlaufen

For every .py file under src/, count function defs and rough cyclomatic complexity using AST.✓ Kopiert

→ Per-Datei-Tabelle
Ranken

Top 10 most complex functions — report file, line, name, score.✓ Kopiert

→ Priorisierte Hotspot-Liste

Ergebnis: Priorisierter Refactoring-Backlog.

Fallstricke

Zyklomatische Komplexität ≠ Lesbarkeit — Reviewer-Urteil einbeziehen; Metrik ist ein Startpunkt

Kombinationen

Mit anderen MCPs für 10-fache Wirkung

tree-sitter-mcp + semble-mcp

Semantischer Recall (semble) + strukturelle Präzision (tree-sitter)

Use semble to find probable call sites, then tree-sitter to verify each is a real identifier.✓ Kopiert

tree-sitter-mcp + filesystem

Nur die AST-abgeleiteten Bereiche lesen

Tree-sitter the function range, then filesystem to dump the exact bytes.✓ Kopiert

Werkzeuge

Was dieses MCP bereitstellt

Werkzeug	Eingaben	Wann aufrufen	Kosten
parse_file	path	Vollständigen AST einer Datei laden	free
list_symbols	path, kind?	Top-Level-Inventar	free
find_definition	name, scope?	Lokalisieren, wo etwas definiert ist	free
find_references	name	Call-Stellen für sicheres Rename finden	free
get_node	path, byte_range or line_range	Exakten Knoten für Refactoring aufteilen	free

Kosten & Limits

Was der Betrieb kostet

API-Kontingent: Keine — lokal
Tokens pro Aufruf: 100–1500
Kosten in €: Kostenlos
Tipp: Knoten aufteilen, nicht ganze Dateien laden

Sicherheit

Rechte, Secrets, Reichweite

Minimale Scopes: Local file read

Credential-Speicherung: Keine

Datenabfluss: Keine

Fehlerbehebung

Häufige Fehler und Lösungen

Language not supported

Die relevante Tree-sitter-Grammatik hinzufügen; unterstützte Liste im README prüfen

Parse errors on partial files

Tree-sitter erholt sich, markiert aber ERROR-Knoten; ignorieren oder syntaktisch korrigieren

Slow first run

Grammatik-Kompilierung geschieht einmalig; nachfolgende Läufe sind schnell

Alternativen

Tree-sitter MCP vs. andere

Alternative	Wann stattdessen	Kompromiss
ast-grep	CLI-first strukturelles Such/Ersetze-Tool gewünscht	Weniger als MCP integriert
Language servers (LSP)	Vollständige Typauflösung nötig, nicht nur Syntax	Schwereres Setup; ein Server pro Sprache

Mehr

Ressourcen

📖 Offizielle README auf GitHub lesen

🐙 Offene Issues ansehen

🔍 Alle 400+ MCP-Server und Skills durchsuchen