Tree-sitter MCP — Casos de uso, Instalar & Demo en vivo

Por qué usarlo

Características clave

Tree-sitter bajo el capó — más de 30 gramáticas de lenguajes
Navegación consciente de símbolos: definiciones, referencias, llamantes
Extrae nodos AST exactos (función, clase, método)
Evita las trampas de regex en las que caen los agentes basados en grep
Local — sin llamadas a modelos, solo análisis

Demo en vivo

Cómo se ve en la práctica

tree-sitter-mcp.replay ▶ listo

0/0

Instalar

Elige tu cliente

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

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

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

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

Cursor usa el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

VS Code → Cline → MCP Servers → Edit

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

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

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

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json

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

Continue usa un array de objetos de servidor en lugar de un mapa.

~/.config/zed/settings.json

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

Añádelo a context_servers. Zed recarga en caliente al guardar.

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

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: Tree-sitter MCP

Renombrar una función sin renombrar un string que casualmente coincide

👤 Devs haciendo refactorizaciones ⏱ ~15 min intermediate

Cuándo usarlo: Quieres renombrar validateToken → verifyToken y no también el docstring que dice 'this validates token'.

Flujo

Encontrar definición

Usa el MCP de tree-sitter. Encuentra la definición de validateToken — solo la función, ignora strings y comentarios.✓ Copiado

→ Nodo AST con file:line y tipo de nodo 'function_definition'
Encontrar referencias

Encuentra todos los sitios de llamada de validateToken — solo coincidencias de resolución de identificador.✓ Copiado

→ Lista de referencias, sin falsos positivos en strings
Renombrar

Renombra a verifyToken en todos los sitios donde es una referencia real. Muéstrame el diff.✓ Copiado

→ Diff con N renombramientos solo en posiciones de identificador

Resultado: Renombramiento limpio que no toca comentarios, strings ni docs.

Errores comunes

Las pérdidas por despacho dinámico / reflexión — Combina con semble para recall semántico de usos dinámicos

Combinar con: filesystem · semble-mcp

Extraer el cuerpo exacto de una función para una refactorización de extracción de método

👤 Ingenieros limpiando funciones largas ⏱ ~20 min intermediate

Cuándo usarlo: Quieres extraer las líneas 42–87 de una función en un helper — de forma quirúrgica.

Flujo

Extraer

Muéstrame el nodo AST exacto para el for-loop en la línea 42 de handler.py.✓ Copiado

→ Nodo de bucle con rangos de bytes
Refactorizar

Mueve ese bucle a una nueva función process_batch. Reemplaza el original con una llamada.✓ Copiado

→ Diff de refactorización que respeta la indentación y el alcance originales

Resultado: Refactorización que compila al primer intento.

Errores comunes

Las variables capturadas no se elevan a argumentos — Pide a Claude que enumere las variables libres antes de extraer

Calcular métricas de complejidad por archivo

👤 Managers de ingeniería / auditorías de deuda técnica ⏱ ~25 min intermediate

Cuándo usarlo: Necesitas un mapa de puntos calientes de código complejo.

Flujo

Recorrer

Para cada archivo .py bajo src/, cuenta las definiciones de funciones y la complejidad ciclomática aproximada usando el AST.✓ Copiado

→ Tabla por archivo
Clasificar

Las 10 funciones más complejas — informa de archivo, línea, nombre, puntuación.✓ Copiado

→ Lista de puntos calientes clasificada

Resultado: Backlog de refactorización priorizado.

Errores comunes

Complejidad ciclomática ≠ legibilidad — Combina con juicio del revisor; la métrica es un punto de partida

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

tree-sitter-mcp + semble-mcp

Recall semántico (semble) + precisión estructural (tree-sitter)

Usa semble para encontrar sitios de llamada probables, luego tree-sitter para verificar que cada uno es un identificador real.✓ Copiado

tree-sitter-mcp + filesystem

Leer solo los rangos derivados del AST

Obtén el rango de la función con tree-sitter, luego usa filesystem para volcar los bytes exactos.✓ Copiado

Herramientas

Lo que expone este MCP

Herramienta	Entradas	Cuándo llamar	Coste
parse_file	path	Obtener el AST completo de un archivo	free
list_symbols	path, kind?	Inventario de nivel superior	free
find_definition	name, scope?	Localizar dónde está definido algo	free
find_references	name	Encontrar sitios de llamada para un renombramiento seguro	free
get_node	path, byte_range or line_range	Extraer nodo exacto para refactorización	free

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API: Ninguna — local
Tokens por llamada: 100–1500
Monetario: Gratis
Consejo: Extrae nodos, no vuelques archivos completos

Seguridad

Permisos, secretos, alcance

Ámbitos mínimos: Local file read

Almacenamiento de credenciales: Ninguno

Salida de datos: Ninguno

Resolución de problemas

Errores comunes y soluciones

Lenguaje no soportado

Añade la gramática Tree-sitter relevante; revisa la lista de soportados en el README

Errores de análisis en archivos parciales

Tree-sitter se recupera pero marca nodos ERROR; ignóralos o corrígelos sintácticamente

Primera ejecución lenta

La compilación de la gramática ocurre una vez; las ejecuciones siguientes son rápidas

Alternativas

Tree-sitter MCP vs otros

Alternativa	Cuándo usarla	Contrapartida
ast-grep	Quieres una herramienta de búsqueda/reemplazo estructural primero CLI	Menos integrado como MCP
Servidores de lenguaje (LSP)	Necesitas resolución de tipos completa, no solo sintaxis	Configuración más pesada; un servidor por lenguaje

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills