# dep-scope

Inspects JavaScript and TypeScript npm imports at the symbol level, highlights native replacements, and writes LLM refactoring prompts.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 19
- Author: FlorianBruniaux
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/FlorianBruniaux/node-dep-scope
- Updated: 2026-09-01
- HTML: https://affpapa.org/en/nevibecode/mcp/dep-scope

## What it does

Most package linters stop at marking a dependency active or dead. This server evaluates the specific symbols imported into TypeScript or JavaScript source trees. It matches those symbols against a registry containing 195 packages with native replacements. When an external helper can yield to standard language features, it flags the call for replacement.

Beyond static reporting, the server writes structured migration prompts tailored for coding agents. It supports monorepos, tracks duplicate packages, and surfaces transitive polyfills. Build and test configurations from tools like Vite or Vitest are checked automatically. This prevents false alarms on dependencies referenced solely within configuration objects.

Running this server requires Node.js version 18 or newer. Projects keeping source code outside typical folders like `src` or `app` risk inaccurate removal flags unless explicit paths are passed in `.depscoperc.json`.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add dep-scope -- npx -y @florianbruniaux/dep-scope
```

### Codex

**Platform CLI**
```bash
codex mcp add dep-scope -- npx -y @florianbruniaux/dep-scope
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "dep-scope": {
            "command": "npx",
            "args": [
                "-y",
                "@florianbruniaux/dep-scope"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "dep-scope": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@florianbruniaux/dep-scope"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add dep-scope npx -y @florianbruniaux/dep-scope
```

## When to use it
- identify native standard replacements for utility packages
- generate refactoring prompts for automated code migrations
- inspect which symbols are imported from large dependencies
- spot duplicate packages and transitive polyfills across a monorepo

## Example prompts
- Run a dep-scope audit on this project and list packages that can be replaced with native code
- Generate an LLM migration prompt to remove lodash imports
- Check dependencies for duplicates and transitive polyfills

## Similar
- [Front-End Checklist](https://affpapa.org/en/nevibecode/mcp/front-end-checklist.md) — MCP server · ★ 74559
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [Serena MCP: the IDE for your agent](https://affpapa.org/en/nevibecode/mcp/serena-mcp-the-ide-for-your-agent.md) — MCP server · ★ 30677
- [Repomix](https://affpapa.org/en/nevibecode/mcp/repomix.md) — MCP server · ★ 29027
- [Repowise](https://affpapa.org/en/nevibecode/mcp/repowise.md) — MCP server · ★ 7891
- [sem](https://affpapa.org/en/nevibecode/mcp/sem.md) — MCP server · ★ 3422

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
