ast-outline-mcp

MCP server for ast-outline — a tree-sitter-based CLI that lets AI coding agents pull exactly what they need from a codebase: structural outlines, module digests, symbol bodies, and AST-aware grep.

An MCP (Model Context Protocol) server forast-outline— a tree-sitter-based CLI that lets AI coding agents pull exactly what they need from a codebase: structural outlines, module digests, symbol bodies, and AST-aware grep.

- Node.js >= 18
- ast-outlineCLI installed and available on PATH (installation guide)

npm install -g ast-outline-mcp ast-outline-mcp

{ "mcpServers": { "ast-outline": { "command": "npx", "args": ["ast-outline-mcp"] } } }

Get a compact one-page module map of a directory. Each file gets a size label and token estimate. Recommended for initial overview of a codebase.

- path(string, required) — Directory path to digest

Get a structural outline of one or more files or directories. Returns signatures with line ranges (no bodies).

- path(string, required) — File or directory path to outline
- imports(boolean) — Include import/use/using statements
- noPrivate(boolean) — Exclude private members
- noFields(boolean) — Exclude fields/properties
- noDocs(boolean) — Exclude documentation comments
- noAttrs(boolean) — Exclude attributes/decorators

Extract the full source body of one or more symbols from a file.

- file(string, required) — File path to extract symbols from
- symbols(string[], required) — Symbol names to extract
- signature(boolean) — Return header/signature only, no body

AST-aware structural search across files. Matches grouped by enclosing class/function.

- pattern(string, required) — Search pattern (literal or regex, auto-detected)
- path(string, required) — File or directory path to search
- kind(enum: def|call|ref|import) — Narrow results by classification kind
- wordMatch(boolean) — Match whole words only
- caseInsensitive(boolean) — Case-insensitive matching
- filesOnly(boolean) — List matching files only
- count(boolean) — Show match counts per file
- maxCount(number) — Maximum number of matches per file

A prompt that guides an LLM to efficiently explore a codebase using ast-outline tools.

ast-outline supports 20+ languages including TypeScript, Python, Go, Rust, C#, Java, Kotlin, Ruby, PHP, and more. See thefull list.

Build and deploy full-stack Next.js apps with 98 tools for React, AWS, and MongoDB