AST Metrics

What it does

AST Metrics connects AI coding agents to the structural reality of a codebase. Instead of reading files linearly, the AI can query high-level architectural metrics, identify risky code, and understand component coupling to make informed refactoring decisions.

Tools

• analyze_project: Provides a high-level overview of languages, complexity, and top risks.
• get_file_metrics: Returns detailed metrics for a specific file.
• find_risky_code: Identifies files or classes with the highest risk scores.
• find_complex_code: Locates functions or classes exceeding complexity thresholds.
• get_dependencies: Retrieves a dependency subgraph around a specific component.
• get_coupling: Measures afferent and efferent coupling for a component.
• get_communities: Performs architectural community detection.
• get_test_quality: Evaluates test isolation and identifies orphan classes.

Installation

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "ast-metrics": {
      "command": "ast-metrics",
      "args": ["mcp", "."]
    }
  }
}

Supported hosts

• Claude Desktop
• Cursor