angrysky56/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:
bash
git clone https://github.com/angrysky56/ast-mcp-server.git
cd ast-mcp-server
2. Install the project and dependencies:
bash
# 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:
bash
uv run build-parsers
### Using pip (Alternative)
bash
# 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 buildparsers.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/claudedesktopconfig.json
Linux: ~/.config/claude-desktop/claudedesktopconfig.json
Windows: %APPDATA%\claude-desktop\claudedesktopconfig.json
2. Add the AST MCP server configuration:
json
"mcpServers": {
"AstAnalyzer": {
"command": "uv",
"args": [
"--directory",
"/home/ty/Repositories/aiworkspace/ast-mcp-server/astmcpserver",
"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
bash
# 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:
bash
# Using uv
uv run --extra dev -- -m mcp dev server.py
# Or using the development script
./devserver.sh
### Testing
bash
# Run all tests
uv run --extra testing pytest
# Run tests with coverage
uv run --extra testing pytest --cov=astmcpserver --cov-report=html
# Run specific tests
uv run --extra testing pytest tests/testspecific.py
### Code Quality
bash
# Format code
uv run black .
uv run isort .
# Lint code
uv run flake8 .
# Type checking
uv run mypy astmcpserver/
## Available Tools
The server provides the following tools for code analysis:
### Basic Tools
parsetoast: Parse code into an Abstract Syntax Tree
generateasg: Generate an Abstract Semantic Graph from code