freshdeps-mcp

MCP server exposing live npm / PyPI dependency-health verdicts so AI coding agents can check a package before recommending it — closing the 6–18 month staleness gap in model training data.

Tool

check_dependency_freshness

Input	Type
ecosystem	"npm" | "pypi"
package	string

Returns a concise human-readable summary and structured content: maintenance signal (active/slowing/stale/abandoned/unknown), latest version, last release/commit age, deprecation/yank/archived flags, known CVE count (OSV), and a hand-verified alternative if the package is dead.

It calls ${FRESHDEPS_API_BASE}/api/verdict (default https://freshdeps.vercel.app).

Install (Claude Desktop / Cursor)

Once published:

{
  "mcpServers": {
    "freshdeps": { "command": "npx", "args": ["-y", "freshdeps-mcp"] }
  }
}

From this repo (before publish):

{
  "mcpServers": {
    "freshdeps": {
      "command": "node",
      "args": ["/absolute/path/to/code/mcp/server.js"]
    }
  }
}

Run / test manually

npm install
FRESHDEPS_API_BASE=http://localhost:3100 node server.js

The server speaks JSON-RPC over stdio (StdioServerTransport).

Env

Var	Purpose
FRESHDEPS_API_BASE	backend base URL (default prod)
GOATCOUNTER_CODE	optional fire-and-forget usage analytics