# 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:

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

From this repo (before publish):

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

## Run / test manually

```bash
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 |