All servers / Developer / AST Reader MCP server
AST Reader MCP server
Structural code MCP server and batch CLI for compact TypeScript/JavaScript reads and hash-bound AST edits.
Tested by ConnectATDScore 88 out of 100. Tested 2026-11-18 on package version 0.20.4. Package: ast-mcp-server · source
Score breakdown
| Runs | 18 / 20 | |
|---|---|---|
| Tool descriptions | 18 / 20 | |
| Package safety | 20 / 20 | |
| Maintenance | 20 / 20 | |
| Adoption | 12 / 20 |
What we saw
- Starts and answers the MCP handshake: yes (21.3 seconds including download)
- Tools offered: 15
- Last published: 2026-11-18
- Weekly downloads (npm): 1,817
- License: ISC · Direct dependencies: 6
Want this server set up for your team?
ConnectATD builds AI automation and wires up MCP servers like this one. Tell us what you are trying to do.
Talk to ConnectATDTools and how they are described
Agents choose tools from these descriptions. Under each name you can see how many of its parameters are explained.
ast_list_files4 of 4 parameters describedLists source files included by the project's tsconfig in deterministic, project-relative, paginated form.
ast_get_project_status1 of 1 parameter describedReturns bounded, read-only compiler freshness and project status without exposing filesystem identities or credentials.
ast_explore16 of 16 parameters describedComposes bounded structural search, exact selectors, source evidence and compiler references without weakening the primitive AST tools. Returns bounded session freshness metadata for fresh, pending, stale, rebuilding or degraded state.
ast_get_outline3 of 3 parameters describedReturns body-free declaration signatures for one TypeScript/JavaScript file. Detailed symbol metadata is opt-in because it duplicates signature text.
ast_get_symbol_source3 of 3 parameters describedReturns exactly one declaration or implementation with its project-relative location, not the complete file.
ast_search_symbols8 of 8 parameters describedRanks structural declarations and returns exact file/symbol selectors for downstream AST tools.
ast_find_references7 of 8 parameters describedFinds type-resolved references and returns bounded project-relative locations, including declaration impact by default. When @angular/compiler resolves, it also reports Angular template usages, including consumer templates, tagged by origin with a template_coverage verdict; completed covers templates inside the Project only, incomplete coverage does not prove absence. It reports usages only; template type errors are reported by ast_rename_symbol plans in template_diagnostics.
ast_get_impact9 of 9 parameters describedTraverses exact compiler-backed relationships around a symbol with explicit direction, depth, node and edge budgets. Returns bounded session freshness metadata and fails closed when exact relationships are not fresh. Read-only evidence only; it never prepares or applies mutations.
ast_find_test_candidates2 of 10 parameters describedFinds deterministic affected test candidates from fresh, complete incoming compiler relationships. Returns bounded whole-candidate proofs and never executes tests or prepares mutations.
ast_get_diagnostics5 of 6 parameters describedReturns bounded normalized TypeScript diagnostics for a project or one source file. Existing errors are preserved as evidence for write-operation delta checks.
ast_get_file5 of 5 parameters describedReturns exact bounded source lines for one TypeScript/JavaScript file, or body-free symbols when symbols_only is true. Read-only; file snapshot freshness and project freshness are reported separately from compiler diagnostics.
ast_rename_symbol4 of 7 parameters describedPrepares an exact hash-bound rename plan without writing. Review the preview and apply its operation_id with ast_apply_operation. The plan also rewrites external Angular templates, including consumer templates when coverage is completed, hash-bound to the workspace snapshot. The diagnostics field stays TypeScript-only; when templates are edited, template_diagnostics reports the template type-check delta separately with a typed status, and blocks only with block_on_template_errors=true.
ast_replace_symbol_body3 of 6 parameters describedPrepares a hash-bound body replacement while preserving the signature. Supports declarations, methods, accessors and function-valued variables/properties.
ast_scaffold_class0 of 12 parameters describedPrepares a hash-bound new TypeScript class file without writing it. Each method body throws an explicit not-implemented error. Review the diff, then apply the returned operation_id and plan_hash with ast_apply_operation.
ast_get_operation_preview1 of 2 parameters describedRetrieves exact unified diffs retained for a prepared operation, optionally one affected file at a time.
Tested in a sandbox with an empty environment: no API keys, a throwaway folder, nothing from a real account. A passing test shows the server runs and responds. It is not a security audit.