TypeScript AST MCP Server

Ein Model Context Protocol (MCP)-Server, der TypeScript-AST-Analysefunktionen (Abstract Syntax Tree) bereitstellt. Mit diesem Server können Sie Referenzen für Klassen und Methoden finden, Komponentenbäume analysieren und Abhängigkeiten in TypeScript-Code mithilfe der ts-morph-Bibliothek finden.

Features

• MCP-Server: Implementiert das Model Context Protocol für die Integration mit KI-Assistenten.

• TypeScript-Analyse: Verwendet ts-morph für leistungsstarke TypeScript-AST-Parsing- und -Analysefunktionen.

• Referenzsuche: Finden Sie alle Referenzen zu einer bestimmten Klassenmethode in Ihrer Codebasis.

• Abhängigkeitssuche: Verwenden Sie das Tool find_dependency, um alle Dateien aufzulisten, die eine bestimmte Bibliothek importieren.

• Komponentenbaum-Analyse: Verwenden Sie das Tool component_tree, um React-Komponentenstrukturen in Ihrer Codebasis zu analysieren.

• Die Tools sind Teil des MCP-Servers und können über Claude Code oder andere MCP-Clients aufgerufen werden.

Related MCP server: agent-workspace-mcp

Voraussetzungen

• Node.js (mit dem Projekt kompatible Version)

• Yarn-Paketmanager

Einrichtung

1. Klonen Sie das Repository.

2. Installieren Sie die Abhängigkeiten:

   yarn install

3. Kopieren Sie die Beispielkonfigurationsdateien:

   cp .env.example .env

4. Aktualisieren Sie .env mit dem tsconfig-Pfad Ihres Projekts:

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

So führen Sie es aus

Bauen Sie das Projekt:

yarn build

Testen Sie den MCP-Server:

yarn test:mcp

Dies startet den MCP-Server, der von MCP-kompatiblen Clients verbunden werden kann.

Installation in Claude Code

Um diesen MCP-Server in Claude Code zu verwenden:

1. Bauen Sie den Server:

   yarn build

2. Konfigurieren Sie Claude Code:

• Kopieren Sie .mcp.example.json nach .mcp.json (oder aktualisieren Sie Ihre vorhandene Datei mit dem Inhalt der MCP-Konfiguration)

• Bearbeiten Sie Ihre .claude/settings.local.json und fügen Sie den MCP-Abschnitt hinzu (oder den benötigten Teil, wenn Sie bereits einige MCPs konfiguriert haben)

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

• Starten Sie Claude Code

• Geben Sie den Befehl /mcp ein und prüfen Sie, ob der MCP verbunden ist

Entwicklung

Aktualisieren Sie den Code:

1. Nehmen Sie Änderungen an den TypeScript-Quelldateien in src/ vor.

2. Bauen Sie das Projekt:

   yarn build

3. Testen Sie die Änderungen:

   yarn test:mcp

Umgebungsvariablen

Der Server verwendet die folgende Umgebungsvariable:

• PROJECT_TSCONFIG_PATH: Pfad zur tsconfig.json-Datei für die Projektanalyse (Standard: 'tsconfig.json')

Beispielkonfigurationsdateien

• .env.example: Beispiel-Umgebungsvariablendatei

• .mcp.example.json: Beispiel-MCP-Konfigurationsdatei (falls zutreffend)

Tool-Beschreibungen

Der Server bietet drei Tools:

1. find_reference

Finden Sie alle Referenzen zu einer bestimmten Klassenmethode in Ihrer Codebasis.

• Eingabe:

  • filePath: Pfad zur Datei

  • className: Name der Klasse

  • methodName: Name der Methode

• Ausgabe: Liste der Dateipfade mit Zeilennummern, an denen die Methode referenziert wird

2. find_dependency

Listen Sie alle Dateien auf, die eine bestimmte Bibliothek importieren.

• Eingabe:

  • dependencyName: Name der zu suchenden Abhängigkeit

• Ausgabe: Liste der Dateipfade, die die angegebene Abhängigkeit importieren

3. component_tree

Analysieren Sie React-Komponentenstrukturen in Ihrer Codebasis.

• Eingabe:

  • entryFilePath: Pfad zur Einstiegsdatei

  • maxDepth: Maximale Tiefe des Komponentenbaums (Standard: 3)

  • data-id (optional): Attributname, der in TreeNode.dataId erfasst werden soll (Beispiel: data-attribute-id)

• Ausgabe: JSON-Darstellung der Komponentenbaumstruktur, einschließlich optionaler Elementmetadaten wie props, dataId und onClick

Lizenz

MIT