srijanshukla18/xray

Overview

XRAY MCP is a Python tool that gives AI assistants structural code intelligence by analyzing codebases with ast-grep. It enables navigation and understanding of code through progressive analysis of syntax trees.

Best for

Best for
Developers building AI coding assistants that need structural code understanding

Use cases

• Enabling AI assistants to navigate and understand large codebases
• Performing structural code searches and pattern matching
• Providing context-aware code intelligence for development workflows

How to use

Install

uvx --from . xray-mcp

Tools exposed

• uv
• ast-grep

Tested with

Claude Desktop, Claude Code, Cursor, VS Code

Notes

XRAY MCP is a Python tool that gives AI assistants structural code intelligence by analyzing codebases with ast-grep. It enables navigation and understanding of code through progressive analysis of syntax trees.

49 stars on GitHub. Last updated 2025-12-11. Licensed MIT.

Use cases

• Enabling AI assistants to navigate and understand large codebases
• Performing structural code searches and pattern matching
• Providing context-aware code intelligence for development workflows

Pros

• Leverages ast-grep for fast, reliable structural analysis
• Lightweight Python implementation with clear focus
• Open source with active community (49 stars)

Cons

• Limited to Python runtime and ast-grep supported languages
• Small user base may mean fewer integrations and examples
• Requires ast-grep to be installed separately

Indexed from awesome-mcp-servers-punkpeye and enriched against its public facts.