ast-outline-mcp

Servidor MCP para ast-outline — una CLI basada en tree-sitter que permite a los agentes de codificación de IA extraer exactamente lo que necesitan de un código base: esquemas estructurales, resúmenes de módulos, cuerpos de símbolos y grep con conocimiento de AST.

GitHub
1
Prueba este MCPPatrocinado

Documentación

ast-outline-mcp

Un servidor MCP (Protocolo de Contexto de Modelo) para ast-outline — una CLI basada en tree-sitter que permite a los agentes de codificación de IA extraer exactamente lo que necesitan de un código base: esquemas estructurales, resúmenes de módulos, cuerpos de símbolos y búsqueda grep consciente del AST.

Por qué

Los agentes de codificación de LLM exploran códigos base leyendo archivos directamente. Un archivo de 1200 líneas cuesta 1200 líneas de contexto solo para responder "¿qué métodos hay aquí?" — ast-outline proporciona la forma del archivo en 60–100 líneas, y este servidor MCP expone esa funcionalidad a cualquier cliente compatible con MCP.

Requisitos previos

uv tool install ast-outline

Instalación

Ejecutar vía npx (sin necesidad de instalar)

npx ast-outline-mcp

Instalar globalmente

npm install -g ast-outline-mcp
ast-outline-mcp

Configuración del Cliente MCP

Agregue a su configuración de cliente MCP (por ejemplo, Claude Desktop):

{
  "mcpServers": {
    "ast-outline": {
      "command": "npx",
      "args": ["ast-outline-mcp"]
    }
  }
}

Herramientas

digest

Obtenga un mapa de módulo compacto de una página para un directorio. Cada archivo recibe una etiqueta de tamaño y una estimación de tokens. Recomendado para una visión general inicial de un código base.

Parámetros:

  • path (cadena, obligatorio) — Ruta del directorio a resumir

outline

Obtenga un esquema estructural de uno o más archivos o directorios. Devuelve firmas con rangos de líneas (sin cuerpos).

Parámetros:

  • path (cadena, obligatorio) — Ruta de archivo o directorio a esquematizar
  • imports (booleano) — Incluir declaraciones de importación/uso/using
  • noPrivate (booleano) — Excluir miembros privados
  • noFields (booleano) — Excluir campos/propiedades
  • noDocs (booleano) — Excluir comentarios de documentación
  • noAttrs (booleano) — Excluir atributos/decoradores

show

Extraiga el cuerpo fuente completo de uno o más símbolos de un archivo.

Parámetros:

  • file (cadena, obligatorio) — Ruta del archivo del cual extraer símbolos
  • symbols (cadena[], obligatorio) — Nombres de símbolos a extraer
  • signature (booleano) — Devolver solo el encabezado/firma, sin cuerpo

grep

Búsqueda estructural consciente del AST en archivos. Las coincidencias se agrupan por clase/función contenedora.

Parámetros:

  • pattern (cadena, obligatorio) — Patrón de búsqueda (literal o regex, auto-detectado)
  • path (cadena, obligatorio) — Ruta de archivo o directorio a buscar
  • kind (enumeración: def|call|ref|import) — Reducir resultados por tipo de clasificación
  • wordMatch (booleano) — Coincidir solo palabras completas
  • caseInsensitive (booleano) — Coincidencia sin distinguir mayúsculas/minúsculas
  • filesOnly (booleano) — Listar solo archivos coincidentes
  • count (booleano) — Mostrar conteos de coincidencias por archivo
  • maxCount (número) — Número máximo de coincidencias por archivo

Prompts

explore-codebase

Un prompt que guía a un LLM para explorar eficientemente un código base usando las herramientas de ast-outline.

Desarrollo

npm install
npm test
npm run build

Lenguajes Soportados

ast-outline soporta más de 20 lenguajes, incluyendo TypeScript, Python, Go, Rust, C#, Java, Kotlin, Ruby, PHP y más. Consulte la lista completa.

Licencia

MIT