TypeScript AST MCP Server

Сервер Model Context Protocol (MCP), предоставляющий возможности анализа TypeScript AST (Abstract Syntax Tree). Этот сервер позволяет находить ссылки на классы и методы, анализировать деревья компонентов и находить зависимости в TypeScript-коде с помощью библиотеки ts-morph.

Возможности

• MCP-сервер: Реализует Model Context Protocol для интеграции с AI-ассистентами

• Анализ TypeScript: Использует ts-morph для мощного анализа и разбора TypeScript AST

• Поиск ссылок: Найдите все ссылки на заданный метод класса в вашей кодовой базе

• Поиск зависимостей: Используйте инструмент find_dependency, чтобы получить список всех файлов, которые импортируют указанную библиотеку.

• Анализ дерева компонентов: Используйте инструмент component_tree для анализа структур React-компонентов в вашей кодовой базе.

• Инструменты являются частью MCP-сервера и могут вызываться через Claude Code или другие MCP-клиенты.

Related MCP server: agent-workspace-mcp

Предварительные требования

• Node.js (версия, совместимая с проектом)

• Менеджер пакетов Yarn

Установка

1. Клонируйте репозиторий

2. Установите зависимости:

   yarn install

3. Скопируйте примеры файлов конфигурации:

   cp .env.example .env

4. Обновите .env, указав путь к tsconfig вашего проекта:

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

Как запустить

Соберите проект:

yarn build

Протестируйте MCP-сервер:

yarn test:mcp

Это запустит MCP-сервер, к которому могут подключаться MCP-совместимые клиенты.

Установка в Claude Code

Чтобы использовать этот MCP-сервер в Claude Code:

1. Соберите сервер:

   yarn build

2. Настройте Claude Code:

• Скопируйте .mcp.example.json в .mcp.json (или обновите существующий файл содержимым MCP-конфигурации)

• Отредактируйте ваш .claude/settings.local.json и добавьте раздел MCP (или его часть, если у вас уже настроены некоторые MCP)

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

• Запустите Claude Code

• Введите команду /mcp и проверьте, что MCP подключен

Разработка

Обновление кода:

1. Внесите изменения в исходные файлы TypeScript в src/

2. Соберите проект:

   yarn build

3. Проверьте изменения:

   yarn test:mcp

Переменные окружения

Сервер использует следующую переменную окружения:

• PROJECT_TSCONFIG_PATH: Путь к файлу tsconfig.json для анализа проекта (по умолчанию 'tsconfig.json')

Примеры файлов конфигурации

• .env.example: Пример файла переменных окружения

• .mcp.example.json: Пример MCP-конфигурации (если применимо)

Описание инструментов

Сервер предоставляет три инструмента:

1. find_reference

Находит все ссылки на заданный метод класса в вашей кодовой базе.

• Входные данные:

  • filePath: Путь к файлу

  • className: Имя класса

  • methodName: Имя метода

• Выходные данные: Список путей к файлам с номерами строк, где используется метод

2. find_dependency

Выводит список всех файлов, которые импортируют указанную библиотеку.

• Входные данные:

  • dependencyName: Имя зависимости для поиска

• Выходные данные: Список путей к файлам, которые импортируют указанную зависимость

3. component_tree

Анализирует структуры React-компонентов в вашей кодовой базе.

• Входные данные:

  • entryFilePath: Путь к входному файлу

  • maxDepth: Максимальная глубина дерева компонентов (по умолчанию: 3)

  • data-id (необязательно): Имя атрибута для захвата в TreeNode.dataId (пример: data-attribute-id)

• Выходные данные: JSON-представление структуры дерева компонентов, включая необязательные метаданные элементов, такие как props, dataId и onClick

Лицензия

MIT