CodeImpact MCP
Lightweight pre-commit safety gate for AI agents.
When to install
Use this MCP server when the user asks any of:
- "Is this refactoring safe to commit?"
- "What will break if I change this file?"
- "Show me the blast radius of these changes."
- "Which files depend on this module?"
- "Are there circular dependencies in my project?"
- "Give me a safety check before I push."
- "How coupled is this file to the rest of the codebase?"
Install
Pick your client. Everything runs through npx —
nothing to install globally.
{
"mcpServers": {
"code-impact": {
"command": "npx",
"args": ["-y", "@vk0/code-impact-mcp"]
}
}
}claude mcp add --transport stdio code-impact -- npx -y @vk0/code-impact-mcp{
"mcpServers": {
"code-impact": {
"command": "npx",
"args": ["-y", "@vk0/code-impact-mcp"]
}
}
}{
"mcpServers": {
"code-impact": {
"command": "npx",
"args": ["-y", "@vk0/code-impact-mcp"],
"disabled": false,
"alwaysAllow": []
}
}
}Tools
gate_check
Pre-commit safety gate. Returns a PASS / WARN / BLOCK verdict with reasons based on the blast radius of your changes.
analyze_impact
Analyze the blast radius of changing specific files. Returns directly and transitively affected files with a risk score (0-1).
get_dependencies
Get import and importedBy relationships for a file. Shows coupling, fan-in/fan-out, and exports at a glance.
refresh_graph
Rebuild the dependency graph from scratch. Returns file count, edge count, build time, and detected circular dependencies.
How it works
Your TS/JS project ┌──────────────────┐
(imports & exports) ──────────▶ │ ts-morph parser │
│ + graph builder │
└────────┬─────────┘
│
▼
┌──────────────────┐
Agent tool call (stdio MCP) ──▶ │ MCP server │ ── PASS / WARN / BLOCK
│ (4 tools) │
└──────────────────┘
Parses your TypeScript / JavaScript project locally via ts-morph. Read-only. No telemetry, no API key, no cloud sync.