@dowse/mcp

The MCP server of dowse — it exposes behavioral code analysis of a TypeScript monorepo as tools a coding agent can call.

You do not need to install this package. Point your agent at the CLI:

claude mcp add dowse -- npx -y dowse mcp

Then ask, inside a session: "Where should I refactor next?" or "I'm about to change packages/ui — what does that touch?"

Tools

| Tool | What it is for | | ------------------------ | -------------------------------------------------------------------- | | dowse_findings | Places where several indicators overlap. Start here. | | dowse_hotspots | Top hotspots, filterable by count and package | | dowse_hidden_coupling | Package pairs that change together with no dependency | | dowse_explain_coupling | Why they change together — file pairs and representative commits | | dowse_verify_churn | Whether that change frequency is real (AST comparison) | | dowse_package_risk | Hotspot / health / bus factor for a package | | dowse_health_breakdown | Code Health deductions, with function names and line numbers | | dowse_file_metrics | Per-file metric breakdown |

Full descriptions and arguments: https://dowse.yhay81.com/reference/mcp.

Embedding it

npm install @dowse/mcp

import { createDowseMcpServer, startDowseMcpStdio } from "@dowse/mcp";

ESM only. Node.js ^22.18.0 || >=24.11.0.

License

MIT