OXC AST

Provides AST parsing, node documentation, and semantic checks for OXC code via an MCP server.

other

7

GitHub Stars

other

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

You have an experimental MCP server that runs the oxc-ast-mcp toolset. It provides an interface to parse OXC code into an AST, view documentation for AST nodes, and perform syntactic and semantic checks, all in a server you can connect to from MCP clients.

How to use

Connect your MCP client to the oxc-ast MCP server to access three core capabilities: parse(code, ext) to obtain an AST for a snippet, docs(query?) to browse AST node documentation, and check(code, ext, check_semantic) to surface syntactic and semantic diagnostics. Use the server to power tooling like linters or code formatters in your OXC workflow and to verify correctness after implementing code.

How to install

Prerequisites you need on your machine before starting are Node.js and Rust tooling. Ensure you have npm and cargo available in your environment.

Build steps to prepare the MCP server:

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

Install and configure the MCP server with the provided command and arguments. Use the example configuration to wire the server into your MCP client setup.

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

Additional notes

The oxc-ast MCP server exposes three primary capabilities as described in the available tools: parse(code, ext), docs(query?), and check(code, ext, check_semantic = true). Build the AST generator, then compile the Rust backend to enable the MCP endpoint. The example configuration shows how to reference a local runtime binary that will handle incoming MCP requests.

Configuration and usage notes

If you are wiring this server into a broader MCP environment, place the executable at the path you specify in the command field and pass an empty array for args if you do not need extra runtime flags. Ensure permissions allow your MCP client to start and communicate with the server. For environment variables or additional runtime configuration, extend the mcpServers entry with an env map if needed.

Available tools

parse

Parse a code snippet with a given extension and return its AST.

docs

Show documentation for OXC AST nodes, optionally filtered by a query.

check

Check code for syntactic and semantic diagnostics and return issues found.