Oxc Ast MCP

🚀 oxc-ast-mcp

An unofficial and experimental MCP server for the OXC parser, offering essential tools for code analysis and diagnostics.

🚀 Quick Start

This README provides an overview of the oxc-ast-mcp project, an unofficial and experimental MCP server for the OXC parser. It details the available tools, expected use cases, and how to use the project.

✨ Features

Available Tools

parse(code, ext)

Parses the code snippet and returns the Abstract Syntax Tree (AST).

docs(query?)

Displays documentation for each OXC AST node, optionally filtered by a regex query.

check(code, ext, check_semantic = true)

Checks the code and returns syntactic and semantic diagnostics.

Expected Use Cases

• Companion for Tool Implementation: When implementing tools like oxc_linter or oxc_formatter in the OXC repository, understanding the AST structure helps agents handle appropriate AST nodes.
• Operation Verification: After an agent implements code, it can discover basic syntactic and semantic issues before linting and execution.
• And More: There are potentially many other use cases for this tool.

📦 Installation

Build

# If not exists
node generate-oxc_ast-nodes.mjs > ast-nodes.generated.json
cargo build --release

Install (e.g., .mcp.json)

{
  "mcpServers": {
    "oxc-ast": {
      "command": "/path/to/oxc-ast-mcp/target/release/oxc-ast-mcp",
      "args": []
    }
  }
}