freshdeps-mcp

freshdeps-mcp

npm / PyPI の依存関係の健全性をリアルタイムで判定する MCP サーバーです。AI コーディングエージェントがパッケージを推奨する前に確認できるようにし、モデルのトレーニングデータにある 6～18 か月の古さのギャップを埋めます。

ツール

check_dependency_freshness

入力	型
ecosystem	"npm" | "pypi"
package	文字列

簡潔で読みやすい要約と構造化コンテンツを返します。内容は、メンテナンス状況（active／slowing／stale／abandoned／unknown）、最新バージョン、最終リリース／コミットからの経過期間、非推奨／Yank／アーカイブ済みのフラグ、既知の CVE 件数（OSV）、およびパッケージが使われなくなっている場合の手動で検証済みの代替パッケージです。

${FRESHDEPS_API_BASE}/api/verdict を呼び出します（デフォルトは https://freshdeps.vercel.app）。

インストール（Claude Desktop / Cursor）

公開後：

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

このリポジトリから（公開前）：

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

手動での実行／テスト

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

サーバーは stdio 経由で JSON-RPC を使用します（StdioServerTransport）。

環境変数

変数	用途
FRESHDEPS_API_BASE	バックエンドのベース URL（デフォルトは本番環境）
GOATCOUNTER_CODE	オプションの利用状況分析（送信後の応答を待たずに実行）