@deplens/mcp

Model Context Protocol (MCP) server for DepLens.

Run

npx @deplens/mcp

If your MCP host requires a command + args, use one of:

{ "command": "npx", "args": ["--yes", "@deplens/mcp"] }

{ "command": "npm", "args": ["exec", "--", "@deplens/mcp"] }

If npx/npm exec is unreliable, install once and call the binary:

npm i -g @deplens/mcp

{ "command": "deplens-mcp" }

Or point directly to the local bin if installed in a project:

{ "command": "node", "args": ["./node_modules/@deplens/mcp/bin/deplens-mcp.js"] }

Avoid: npm @deplens/mcp (npm will treat it as an unknown command).

This starts an MCP server over stdio.

Tool

deplens.inspect

Input schema (high level)

• target (string, required): package name or import path (e.g. react, next/server)
• subpath (string, optional): appended to target (e.g. server for next/server)
• filter (string)
• kind (string[])
• showTypes (boolean)
• depth (number 0–5)
• resolveFrom (string)
• rootDir (string): working directory for inspection
• jsdoc (off|compact|full)
• jsdocOutput (off|section|inline|only)
• jsdocQuery (object):
  • symbols (string|string[])
  • sections (summary|params|returns|tags)[]
  • tags.include / tags.exclude (string[])
  • mode (compact|full)
  • maxLen (number)
  • truncate (none|sentence|word)

Example call

{
  "target": "ai",
  "showTypes": true,
  "filter": "generate",
  "resolveFrom": ".",
  "jsdocOutput": "section",
  "jsdocQuery": {
    "symbols": "generateText",
    "sections": ["summary", "params", "returns"],
    "tags": { "include": ["param", "returns"] },
    "mode": "compact"
  }
}

Environment

• DEPLENS_ROOT: default rootDir if not provided.

Requirements

• Node.js >= 18

License

MIT