Commands

Install

npm install --save-dev @mwillbanks/ast-mcp

When using Bun, run bun pm trust @ast-bro/cli dprint once after installation. If another manager blocks dependency build scripts, approve @ast-bro/cli and dprint through that manager.

Manage host surfaces

./node_modules/.bin/ast-mcp install --scope local --target all
./node_modules/.bin/ast-mcp install --scope local --target all \
  --transport http --host 127.0.0.1 --port 3768 [--service]
./node_modules/.bin/ast-mcp update --scope local --target all \
  [--transport stdio|http] [--no-service]
./node_modules/.bin/ast-mcp uninstall --scope local --target all

Installer output is JSON containing changed paths, the effective transport, HTTP endpoint, service identity/state, and a manual startup command when no service is managed.

Configuration

ast-mcp config validate
ast-mcp config show
ast-mcp config migrate
ast-mcp config migrate --check
ast-mcp config migrate --write [--no-backup]
ast-mcp config migrate --file ./ast-mcp.toml [--to 2]
ast-mcp config migrate --global [--check|--write]

validate and show resolve environment, project, global, and default layers. Migration defaults to preview; --check exits 0 when current, 2 when migration is required, and 1 for invalid input. --write performs atomic replacement and creates a .v1.bak unless disabled.

Runtime

ast-mcp mcp
ast-mcp mcp --transport http [--host 127.0.0.1] [--port 3768]
bun run dev
bun run dev:http

Runtime HTTP flags have highest precedence. --host and --port are rejected for stdio, and invalid transport or port values return command-specific usage errors.

Quality gates

bun run tools:check
bun run format
bun run format:check
bun run typecheck
bun run test
bun run skill:check
bun run evals:check
bun run fallow

bun run format executes biome check . --write --unsafe --reporter concise --error-on-warnings. The check-only command uses the same warning policy without writing.

Distribution

bun run build
bun pm pack --dry-run

The Bun build bundles bin/ast-mcp.ts into dist/ast-mcp.js as a Bun-targeted ESM executable with an external source map. Its install, update, uninstall, hook, and mcp subcommands share the same stable package dependency tree.

Documentation

bun install --cwd website
bun run --cwd website dev
bun run --cwd website lint
bun run --cwd website typecheck
bun run --cwd website test
VITE_BASE_PATH=/ast-mcp/ bun run --cwd website build