@mcp/dependency-graph

MCP server for dependency graph analysis and visualization in monorepos.

Features

• Build complete dependency graphs from package.json and TypeScript/JavaScript imports
• Visualize dependencies in multiple formats (JSON, Mermaid, DOT, tree)
• Impact analysis - see what breaks when you change a package
• Find circular dependencies - detect problematic dependency cycles
• Identify unused code - find packages with no dependents
• Package info - detailed information about specific packages

Installation

bun add @mcp/dependency-graph

MCP Tools

dependency_graph

Build a complete dependency graph of the monorepo.

{
  "includeDevDependencies": false,
  "analyzeImports": true,
  "excludePatterns": ["^@types/", "^@eslint/"],
  "format": "mermaid"
}

Formats:

• json - Raw JSON output
• mermaid - Mermaid diagram for documentation
• dot - Graphviz DOT format
• tree - ASCII tree visualization

impact_analysis

Analyze the impact of changing a specific package.

{
  "package": "@codespaces/terminal",
  "includeTransitive": true,
  "format": "tree"
}

find_circular

Find circular dependencies in the monorepo.

{
  "maxDepth": 10
}

unused_code

Find potentially unused packages (no dependents).

{
  "includeExternal": false
}

package_info

Get detailed information about a specific package.

{
  "package": "@codespaces/ssh"
}

Usage with Claude Code

Add to your MCP config:

{
  "mcpServers": {
    "dependency-graph": {
      "command": "bun",
      "args": ["/path/to/MCP/packages/dependency-graph/src/index.ts"],
      "cwd": "/path/to/codespaces"
    }
  }
}

Examples

Visualize the monorepo dependency graph

dependency_graph(format="mermaid")

What depends on @codespaces/ssh?

impact_analysis(package="@codespaces/ssh", format="tree")

Find circular dependencies

find_circular()

Find unused packages

unused_code()

Architecture

The server:

1. Discovers all package.json files in the monorepo
2. Parses dependencies from package.json
3. Analyzes TypeScript/JavaScript imports
4. Builds a bidirectional dependency graph
5. Supports queries for impact analysis and visualization

License

MIT