Servidor MCP de TypeScript AST

Un servidor de Model Context Protocol (MCP) que proporciona capacidades de análisis de AST (Árbol de Sintaxis Abstracta) de TypeScript. Este servidor permite encontrar referencias de clases y métodos, analizar árboles de componentes y encontrar dependencias en código TypeScript utilizando la biblioteca ts-morph.

Características

• Servidor MCP: Implementa el Model Context Protocol para la integración con asistentes de IA

• Análisis de TypeScript: Utiliza ts-morph para el análisis y parseo potente de AST de TypeScript

• Búsqueda de referencias: Encuentra todas las referencias a un método de clase dado en tu base de código

• Búsqueda de dependencias: Utiliza la herramienta find_dependency para listar todos los archivos que importan una biblioteca especificada.

• Análisis de árbol de componentes: Utiliza la herramienta component_tree para analizar estructuras de componentes React en tu base de código.

• Las herramientas forman parte del servidor MCP y pueden invocarse mediante Claude Code u otros clientes MCP.

Related MCP server: agent-workspace-mcp

Requisitos previos

• Node.js (versión compatible con el proyecto)

• Gestor de paquetes Yarn

Configuración

1. Clona el repositorio

2. Instala las dependencias:

   yarn install

3. Copia los archivos de configuración de ejemplo:

   cp .env.example .env

4. Actualiza .env con la ruta de tsconfig de tu proyecto:

   PROJECT_TSCONFIG_PATH=/path/to/your/project/tsconfig.json

Cómo ejecutar

Compilar el proyecto:

yarn build

Probar el servidor MCP:

yarn test:mcp

Esto iniciará el servidor MCP que puede ser conectado por clientes compatibles con MCP.

Instalación en Claude Code

Para usar este servidor MCP en Claude Code:

1. Compila el servidor:

   yarn build

2. Configura Claude Code:

• Copia .mcp.example.json a .mcp.json (o actualiza tu archivo existente con el contenido de la configuración MCP)

• Edita tu .claude/settings.local.json y agrega la sección MCP (o el subconjunto necesario si ya tienes algunos MCP configurados)

  “enableAllProjectMcpServers”: true,
  “enabledMcpjsonServers”: [
    “typescript-ast”
  ]

• Inicia Claude Code

• Escribe el comando /mcp y verifica que el MCP esté conectado

Desarrollo

Actualizar el código:

1. Realiza cambios en los archivos fuente de TypeScript en src/

2. Compila el proyecto:

   yarn build

3. Prueba los cambios:

   yarn test:mcp

Variables de entorno

El servidor utiliza la siguiente variable de entorno:

• PROJECT_TSCONFIG_PATH: Ruta al archivo tsconfig.json que se usará para el análisis del proyecto (por defecto: 'tsconfig.json')

Archivos de configuración de ejemplo

• .env.example: Archivo de variables de entorno de ejemplo

• .mcp.example.json: Archivo de configuración MCP de ejemplo (si aplica)

Descripciones de herramientas

El servidor proporciona tres herramientas:

1. find_reference

Encuentra todas las referencias a un método de clase dado en tu base de código.

• Entrada:

  • filePath: Ruta al archivo

  • className: Nombre de la clase

  • methodName: Nombre del método

• Salida: Lista de rutas de archivo con números de línea donde se referencia el método

2. find_dependency

Lista todos los archivos que importan una biblioteca especificada.

• Entrada:

  • dependencyName: Nombre de la dependencia a buscar

• Salida: Lista de rutas de archivo que importan la dependencia especificada

3. component_tree

Analiza estructuras de componentes React en tu base de código.

• Entrada:

  • entryFilePath: Ruta al archivo de entrada

  • maxDepth: Profundidad máxima del árbol de componentes (por defecto: 3)

  • data-id (opcional): Nombre del atributo a capturar en TreeNode.dataId (ejemplo: data-attribute-id)

• Salida: Representación JSON de la estructura del árbol de componentes, incluyendo metadatos opcionales de elementos como props, dataId y onClick

Licencia

MIT