Сервер MCP (Model Context Protocol), который обеспечивает структуру кода и возможности семантического анализа через абстрактные синтаксические деревья (AST) и абстрактные семантические графы (ASG).

Особенности

Парсовый код в абстрактные синтаксические деревья (AST) Генерировать абстрактные семантические графы (ASG) из кода Анализ структуры и сложности кода Поддержка нескольких языков программирования (Python, JavaScript, TypeScript, Go, Rust, C/C++, Java) Совместимость с Claude Desktop и другими MCP-клиентами Дополнительный анализ для более быстрой обработки больших файлов

• Усовершенствованная обработка объема и более полный семантический анализ AST-диффинг для идентификации изменений между версиями кода
• кэширование ресурсов для повышения производительности

##Установка

Предпосылки

Python 3.9 или выше

• менеджер пакетов (рекомендуется) или pip

Использование uv (рекомендуется)

1. Клонировать это хранилище:

2.Установить проект и зависимости:

3. Постройте парсеры для деревьев:

Использование Pip (альтернатива)

Использование с Claude Desktop

1.Настройте Claude Desktop для использования сервера путем редактирования файла конфигурации:

** Расположение файла конфигурирования: **

• macOS: ~/Library/Application Support/claude-desktop/claude_desktop_config.json

AST MCP Server

An MCP (Model Context Protocol) server that provides code structure and semantic analysis capabilities through Abstract Syntax Trees (AST) and Abstract Semantic Graphs (ASG).

Features

• Parse code into Abstract Syntax Trees (AST)
• Generate Abstract Semantic Graphs (ASG) from code
• Analyze code structure and complexity
• Support for multiple programming languages (Python, JavaScript, TypeScript, Go, Rust, C/C++, Java)
• Compatible with Claude Desktop and other MCP clients
• Incremental parsing for faster processing of large files
• Enhanced scope handling and more complete semantic analysis
• AST diffing to identify changes between code versions
• Resource caching for improved performance

Installation

Prerequisites

• Python 3.9 or higher
• uv package manager (recommended) or pip

Using uv (Recommended)

1. Clone this repository:

git clone https://github.com/angrysky56/ast-mcp-server.git
cd ast-mcp-server

2. Install the project and dependencies:

# Install the project in development mode with all dependencies
uv sync

# Or install with specific optional dependencies
uv sync --extra dev  # Development tools
uv sync --extra testing  # Testing dependencies
uv sync --extra docs  # Documentation tools

3. Build the tree-sitter parsers:

uv run build-parsers

Using pip (Alternative)

# Create and activate virtual environment
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install dependencies
pip install -e .

# Build parsers
python build_parsers.py

Usage with Claude Desktop

1. Configure Claude Desktop to use the server by editing your configuration file:

Location of config file:

• macOS: ~/Library/Application Support/claude-desktop/claude_desktop_config.json
• Linux: ~/.config/claude-desktop/claude_desktop_config.json
• Windows: %APPDATA%\claude-desktop\claude_desktop_config.json

2. Add the AST MCP server configuration:

{
  "mcpServers": {
    "AstAnalyzer": {
      "command": "uv",
      "args": [
        "--directory",
        "/home/ty/Repositories/ai_workspace/ast-mcp-server/ast_mcp_server",
        "run",
        "server.py"
      ]
    }
  }
}

Important: Replace /absolute/path/to/ast-mcp-server with the actual absolute path on your system.

3. Restart Claude Desktop to load the new MCP server.

4. In Claude Desktop, you can now use the AST-based code analysis tools by referencing code files or pasting code snippets.

Development

Development Environment Setup

# Install with development dependencies
uv sync --extra dev

# Install pre-commit hooks (optional)
uv run pre-commit install

Running in Development Mode

To run the server in development mode with the MCP inspector:

# Using uv
uv run --extra dev -- -m mcp dev server.py

# Or using the development script