Vigía

Vigia — エージェントがコードを書く前に、アップグレードで何が壊れるかを確認

Vigia は無料のオープンデータサービス（REST API ＋ MCP サーバー）です。AI コーディングエージェントや開発者に、npm、PyPI、Rust（crates.io）パッケージの状態に関する検証済みの日付付き情報を提供します。学習データが古いために言語モデルが間違える情報を確認できます。

🌐 https://vigia.coredls.cloud · MCP: https://vigia.coredls.cloud/mcp · レジストリ: cloud.coredls.vigia/vigia

claude mcp add --transport http vigia https://vigia.coredls.cloud/mcp

MCP サーバーと、エージェントに使用するタイミングを伝えるスキルが含まれるClaude Code プラグインとしてインストールすることもできます。

/plugin marketplace add MatiasDelosSantos/vigia
/plugin install vigia@vigia

ほかのエージェントはスキルを直接利用できます：skills/vigia/SKILL.md（https://vigia.coredls.cloud/skill.md でも提供されています）。

ワンクリックでインストール： Cursor · VS Code

理由

モデルの知識は学習のカットオフ時点で止まりますが、エコシステムでは毎日何千ものリリースが公開されます。そのため、エージェントは変更された API を使ったコードを、自信を持って書いてしまいます。例 — パッケージの TypeScript 型から自動検出した Next.js 14 → 15：

GET /v1/packages/npm/next/upgrade?from=14&to=15

next/headers · cookies   (): ReadonlyRequestCookies   →   (): Promise<ReadonlyRequestCookies>
next/headers · headers   (): ReadonlyHeaders          →   (): Promise<ReadonlyHeaders>
+ new module: next/form
summary: 4 removed exports · 10 changed signatures · 16 changed/removed members · 5 new deprecations

1 回の呼び出しでわかること（ほかのサービスでは答えられない内容）

質問	REST	MCP ツール
X を A から B にアップグレードすると、何が壊れますか？ 削除されたエクスポートやインポートパス、変更されたシグネチャやクラスメンバー、新たな @deprecated、engines／peerDependencies の変更、間の変更履歴	GET /v1/packages/npm/{name}/upgrade?from=14&to=15	upgrade_impact
この API はこのバージョンに存在しますか？ 正確なシグネチャ、インポートパス、非推奨メッセージ、「もしかして」候補	GET /v1/packages/npm/{name}/symbols/{symbol}?version=15	symbol_status
Node 18／React 18／Python 3.8 と互換性のある最新バージョンは？ 各バージョンが宣言する要件に基づいて判定	GET /v1/packages/{npm|pypi}/{name}/compatible?with=node@18,react@18	find_compatible_version
指定したバージョンに脆弱性はありますか？ 最も近い修正版は？（OSV）	GET /v1/packages/{eco}/{name}/versions/{version}	version_status
最新バージョン、非推奨情報、ランタイム要件、ピア依存関係、ライセンス	GET /v1/packages/{eco}/{name}	package_status
package.json／requirements.txt 全体をチェックする	POST /v1/check	check_dependencies
この Python／Node／PHP／Java／Django／Ubuntu…のバージョンはまだサポートされていますか？ サポート終了日はいつですか？（約 480 製品）	GET /v1/eol/{product}/{version}	eol_status
学習カットオフ以降に何が変わりましたか？ 指定した日付以降の新しいメジャーバージョン、ランタイムのリリース、AI モデル	GET /v1/since?cutoff=2025-06	changes_since_cutoff
AI モデルの価格、コンテキストウィンドウ、提供終了日	GET /v1/models	model_status

すべての応答に検証日時とデータの出典が含まれます。完全な仕様：/openapi.json · 18 言語のドキュメント：/docs

エージェント向けプロジェクトコンテキスト（MCP は不要です）

エージェントは AGENTS.md ／ CLAUDE.md を自分で読み込みます。ご利用の依存関係に関する情報（サポート終了ランタイム、脆弱性、非推奨パッケージ、メジャーバージョンの遅れによって発生する問題）を含むブロックを生成します。

• Web：https://vigia.coredls.cloud/context（`package.json` または requirements.txt を貼り付けます）
• スクリプト（依存関係ゼロ、Node 18 以降。先に内容を確認してください）：curl -fsSL https://vigia.coredls.cloud/context.mjs -o vigia-context.mjs && node vigia-context.mjs
• API：POST /v1/context

Claude Code：自動です。 このプラグインにはフックが含まれており、セッション開始時にエージェントへこれらの情報を渡し、package.json または requirements.txt が編集されるたびに再確認します（ツールを呼び出さなくても、Node 18 がサポート終了であることや、lodash に既知の脆弱性があることをエージェントが把握できます）。マニフェストは Vigia に送信されますが、保存されません。フックを無効にするには VIGIA_DISABLE=1 を設定してください。プラグインを使わない場合は、examples/claude-code-settings.json を .claude/settings.json にコピーし、hooks/vigia-hook.mjs を指定してください。

トレーニングのカットオフ以降に変更された内容を月ごとにまとめたページ：https://vigia.coredls.cloud/since

GitHub Action

すべてのプルリクエストで、古い依存関係、非推奨の依存関係、脆弱な依存関係を検出します。

name: dependencies
on: pull_request
permissions:
  contents: read
  pull-requests: write
jobs:
  vigia:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: MatiasDelosSantos/vigia@v1
        with:
          fail-on: vulnerable                        # optional: vulnerable, deprecated, major, outdated
          github-token: ${{ secrets.GITHUB_TOKEN }}  # optional: comment on the PR

バッジ

[![version](https://vigia.coredls.cloud/badge/npm/react/version.svg)](https://vigia.coredls.cloud/npm/react)
[![maintained](https://vigia.coredls.cloud/badge/npm/react/maintained.svg)](https://vigia.coredls.cloud/npm/react)

仕組み

• レジストリが信頼できる情報源です。 npm、PyPI、crates.io のメタデータ（ETag、公開日、バージョンごとの要件（engines、Requires-Python、rust-version）を含む）、npm の履歴情報を提供する deps.dev、脆弱性情報を提供する OSV、AI モデル情報を提供する OpenRouter を利用します。
• API の分析でパッケージのコードが実行されることはありません。 tarball をダウンロードし、.d.ts、package.json、変更履歴のみを抽出します。TypeScript コンパイラ API は、メモリと時間に制限を設けた分離されたワーカースレッドでエクスポートされた宣言を読み取ります。型定義が同梱されていないパッケージでは、@types/* にフォールバックします。
• 情報が上書きされることはありません。 変更があると以前の値を終了し（二時点履歴）、?as_of= を使って「日付 X に Vigia が何を伝えたか」を確認できます。
• 自動更新されます。 ワーカーが約 34,000 件の人気パッケージを追跡します（npm は 15 分～2 時間ごと、PyPI は更新フィード経由、Rust の上位 3,000 クレートは crates.io 経由）。初回リクエスト時に未知のパッケージを解決し、人気の npm パッケージ上位 300 件のアップグレードレポートを事前計算します。

技術スタック：TypeScript、Node 22、Hono、PostgreSQL 17、MCP SDK、Docker。

自分で実行する

cp .env.example .env          # set POSTGRES_PASSWORD and PUBLIC_URL
docker compose up -d          # vigia-db, vigia-api (:3005), vigia-worker
npm install && npm test       # 70 unit tests

データライセンスとプライバシー

Vigia が集約したデータは CC-BY-4.0（「Vigia」と表示）です。上流のデータには、各データソースの利用条件が適用されます。/v1/check に送信されたマニフェストは保存されません。Cookie やトラッカーも使用しません。利用規約 と プライバシーをご覧ください。

ライセンス

コード：AGPL-3.0。運用メモ（スペイン語）：docs/OPERACION.es.md。