io.github.vola-trebla/ast-impact-mapper-mcp
NPM · AST-IMPACT-MAPPER-MCP · SCANNED AUG 3
MCP server that uses TypeScript AST to find which tests are affected by a code change
Available components
How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →
Supply Chain Security87
- No malware found by supply-chain analysis.Pass
- Only part of the dependency tree could be resolved (104 of 108), so this covers what we could see, not the whole tree.Partial
- No install/post-install scripts declared.Pass
- Only part of the dependency tree could be resolved (104 of 108), so this covers what we could see, not the whole tree. View diagnostics → Partial
Provenance & Transparency45
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
- Clear OSI-approved license (MIT).Pass
- Actively maintained (last published 73 days ago).Pass
- Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail
Schema Quality & AI Usability77
- AI-judged instruction clarity (excellent).Pass
- Tool/resource definitions use about 1557 tokens (~103/item across 15 items; 15 tools + 0 resources), lean.Pass
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management23
- Stability observed for 7 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage100
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 100% of tool parameters carry a description.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.
npm · ast-impact-mapper-mcp
claude mcp add vola-trebla-ast-impact-mapper-mcp -- npx -y ast-impact-mapper-mcp
codex mcp add vola-trebla-ast-impact-mapper-mcp -- npx -y ast-impact-mapper-mcp
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"vola-trebla-ast-impact-mapper-mcp": {
"type": "local",
"command": [
"npx",
"-y",
"ast-impact-mapper-mcp"
],
"enabled": true
}
}
} openclaw mcp add vola-trebla-ast-impact-mapper-mcp --command npx --arg -y --arg ast-impact-mapper-mcp
mcp_servers:
vola-trebla-ast-impact-mapper-mcp:
command: "npx"
args: ["-y", "ast-impact-mapper-mcp"] {
"mcpServers": {
"vola-trebla-ast-impact-mapper-mcp": {
"command": "npx",
"args": [
"-y",
"ast-impact-mapper-mcp"
]
}
}
} Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 3 Aug 26 +3
- Stability: unverified → 0.23 ▲ functional
- 2 Aug 26 +45
- Provenance: unverified → fail ▼ security
- Install scripts: unverified → pass ▲ security
- Known CVEs: unverified → partial ▲ security
- Malware scan: unverified → pass ▲ security
- Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window). security
- Tool coverage: 100 → unverified ▼ functional
- Schema quality: unverified → excellent ▲ functional
- License: unverified → pass ▲ functional
- Dependency health: unverified → partial ▲ functional
- Maintenance: unverified → pass ▲ functional
- MCP protocol: unverified → pass ▲ functional
- Licence: MIT functional
- 1 Aug 26 +16
- Tool coverage: unverified → 100 ▲ functional
- 31 Jul 26 −41
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 27 Jul 26 46
First indexed and scored.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 3 Aug 2026 · Analysed npm/[email protected]
Provenance none
Ecosystem: npm · Outcome: none
Dependencies 104 packages
104 packages in the resolved dependency tree · 104 deprecated · 30 stale.
The dependency tree was only partially resolved, so these counts may be incomplete.
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.
analyze_api_surface_mutation ~116
Compares a file against its HEAD version and classifies the change as `breaking_api_change` (exported function signature changed, parameter removed/added, interface field removed) or `internal_refactor` (only implementation body changed). Use to answer: is this PR a breaking change or a safe refactor?
| Name | Type | Req | Description |
|---|---|---|---|
| file_path | string | yes | Path to the changed file (absolute or relative to project_root) |
| project_root | string | yes | Absolute path to the TypeScript project root (must contain tsconfig.json) |
No output schema declared.
No examples provided.
detect_architectural_cycles ~77
Detects circular import dependencies — A imports B which imports C which imports A. Cycles cause unpredictable module initialization order and indicate tight coupling. Use to answer: are there circular dependencies I need to break before refactoring?
| Name | Type | Req | Description |
|---|---|---|---|
| project_root | string | yes | Absolute path to the TypeScript project root (must contain tsconfig.json) |
No output schema declared.
No examples provided.
differentiate_type_impact ~123
Classifies each changed file as type-only or runtime, then splits affected tests into "must run" vs "skippable". A test is skippable when the changed file contains only TypeScript type declarations (interfaces/type aliases) or the test imports it via `import type`. Use to answer: which tests can I skip after a type-only refactor?
| Name | Type | Req | Description |
|---|---|---|---|
| changed_files | array | yes | Changed file paths (absolute or relative to project_root) |
| project_root | string | yes | Absolute path to the TypeScript project root (must contain tsconfig.json) |
No output schema declared.
No examples provided.
explain_impact ~115
Finds the exact import chain that connects a changed source file to a test file. Use to answer: why does changing file X cause test Y to be affected? Returns the step-by-step import path from the test to the changed file.
| Name | Type | Req | Description |
|---|---|---|---|
| changed_file | string | yes | The source file that was changed (absolute or relative to project_root) |
| project_root | string | yes | Absolute path to the TypeScript project root (must contain tsconfig.json) |
| test_file | string | yes | The test file to explain the connection for |
No output schema declared.
No examples provided.
generate_skeleton_view ~106
Generates a token-optimized representation of a source file by stripping function and method bodies, keeping only JSDocs and declarations with line numbers.
| Name | Type | Req | Description |
|---|---|---|---|
| file_path | string | yes | Absolute path to the target source file |
| include_jsdoc | boolean | — | Whether to preserve JSDoc annotations |
| include_private_members | boolean | — | Whether to list private/internal symbols |
| project_root | string | yes | Absolute path to the TypeScript project root (must contain tsconfig.json) |
No output schema declared.
No examples provided.
generate_test_command ~76
Outputs the optimal test execution command for Jest, Vitest, or Playwright based on changed files.
| Name | Type | Req | Description |
|---|---|---|---|
| changed_files | array | yes | List of modified source file paths |
| project_root | string | yes | Absolute path to the TypeScript project root (must contain tsconfig.json) |
| runner | string | — | Test runner to target |
No output schema declared.
No examples provided.
get_affected_tests ~124
Given a list of changed source files, returns which test files are affected — directly or transitively through the import graph. Use to answer: which tests should I run after this code change?
| Name | Type | Req | Description |
|---|---|---|---|
| changed_files | array | — | List of changed file paths (absolute or relative to project_root) |
| git_diff | string | — | Raw output of `git diff --name-only` — newline-separated file paths. Use instead of changed_files when piping git output directly. |
| project_root | string | yes | Absolute path to the TypeScript project root (must contain tsconfig.json) |
No output schema declared.
No examples provided.
get_affected_tests_by_branch ~90
Runs `git diff --name-only <base_branch>...HEAD` internally and returns affected test files. Use instead of get_affected_tests when you want the server to handle the git diff automatically.
| Name | Type | Req | Description |
|---|---|---|---|
| base_branch | string | — | Branch to diff against (default: main) |
| project_root | string | yes | Absolute path to the TypeScript project root (must contain tsconfig.json) |
No output schema declared.
No examples provided.
get_coverage_gaps ~111
Finds source files that are not reachable from any test file through the import graph — i.e. completely untested code. Use to answer: which parts of the codebase have zero test coverage?
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | — | Max uncovered files to return |
| project_root | string | yes | Absolute path to the TypeScript project root (must contain tsconfig.json) |
| source_dirs | array | — | Restrict results to these directories (absolute or relative to project_root). Defaults to the entire project. |
No output schema declared.
No examples provided.
get_dependency_graph ~106
Returns the direct import graph for a specific file: what it imports, and what imports it. Use to answer: what depends on this file? What does this file depend on?
| Name | Type | Req | Description |
|---|---|---|---|
| file_path | string | yes | Path to the file (absolute or relative to project_root) |
| format | string | — | Output format — json (default) or mermaid flowchart diagram |
| project_root | string | yes | Absolute path to the TypeScript project root (must contain tsconfig.json) |
No output schema declared.
No examples provided.
get_rename_aware_diff ~128
Like get_affected_tests_by_branch, but correctly handles renamed and moved files. Uses --find-renames to detect file moves and --ignore-all-space to skip whitespace-only changes. Use instead of get_affected_tests_by_branch when the branch contains refactors or file moves.
| Name | Type | Req | Description |
|---|---|---|---|
| base_branch | string | — | Branch to diff against (default: main) |
| project_root | string | yes | Absolute path to the TypeScript project root (must contain tsconfig.json) |
| similarity_threshold | integer | — | Minimum similarity % to consider a file move a rename (default: 90) |
No output schema declared.
No examples provided.
get_symbol_dependency_graph ~97
Retrieves a bidirectional or directed dependency graph mapped to individual declarations, functions, and variables.
| Name | Type | Req | Description |
|---|---|---|---|
| direction | string | — | Graph traversal direction |
| file_path | string | yes | Absolute path to the TypeScript source file |
| project_root | string | yes | Absolute path to the TypeScript project root (must contain tsconfig.json) |
| symbol_name | string | — | Target export symbol. If omitted, maps all symbols in the file |
No output schema declared.
No examples provided.
get_test_summary ~79
Returns a bird's-eye view of the project's test structure: coverage rate, most-imported source files (highest risk to change), and tests with the deepest import chains. Use to answer: what is the overall test health of this project?
| Name | Type | Req | Description |
|---|---|---|---|
| project_root | string | yes | Absolute path to the TypeScript project root (must contain tsconfig.json) |
No output schema declared.
No examples provided.
identify_unreachable_modules ~144
Finds source files that are never imported by any other file — dead code candidates safe to delete. Automatically excludes known entry points (index.ts, main.ts, pages/, routes/, app/, api/, bin/). Use to answer: which files in this codebase are orphaned and can be safely removed?
| Name | Type | Req | Description |
|---|---|---|---|
| entry_points | array | — | Additional entry point files to exclude (absolute or relative to project_root). Common patterns like index.ts and pages/ are auto-excluded. |
| limit | integer | — | Max unreachable files to return (default: 50) |
| project_root | string | yes | Absolute path to the TypeScript project root (must contain tsconfig.json) |
No output schema declared.
No examples provided.
refresh_project ~65
Clears the cached AST for a project root, forcing a full re-parse on the next call. Use after switching branches, running git pull, or adding/removing files.
| Name | Type | Req | Description |
|---|---|---|---|
| project_root | string | yes | Absolute path to the TypeScript project root (must contain tsconfig.json) |
No output schema declared.
No examples provided.