Hvtracker Mcp

HVTracker MCP

AI エージェント、フレームワーク、MCP サーバーに接続する前に、サプライチェーンの信頼性を確認する MCP サーバーです。

ホスト型リモートサーバーは次のとおりです。

{
  "mcpServers": {
    "hvtracker": {
      "url": "https://hvtracker.net/mcp"
    }
  }
}

このリポジトリでは、パッケージベースでのインストールを希望するクライアント向けに、ローカル stdio パッケージも提供しています。

ツール

• verify_mcp_server：MCP サーバー、パッケージ、GitHub リポジトリ、またはエージェント名の接続前の信頼性判定を行います。
• check_agent_trust：追跡対象の AI エージェントまたはフレームワークの信頼性プロファイルを取得します。ランタイム機能（MCP のステータス、プロバイダー、プラグインの公開範囲、来歴の変化）と、Ed25519 署名付き信頼証明書の URL も含まれます。
• compare_agents：2 つのエージェントを並べて比較し、証拠に基づく判定と、公開済み比較ページへのリンクを提示します。
• search_agents：名前、リポジトリ、説明、またはカテゴリで HVTracker レジストリを検索します。
• scan_stack：依存関係一式の接続前の一括信頼性チェックを行います。requirements.txt、package.json、MCP クライアント設定、または単純なリストを貼り付けると、項目ごとの信頼性判定とスタックの概要を取得できます。
• list_categories：エージェント数とともに HVTracker のカテゴリを一覧表示します。カテゴリのリーダーボードを取得する際に利用できます。
• get_leaderboard：追跡対象の上位 AI エージェントと MCP サーバーを HVTrust スコア順に表示します。必要に応じて 1 つのカテゴリに絞り込めます。
• get_agent_history：追跡対象エージェント 1 つの過去 90 日間の信頼スコア、グレード、順位の履歴を取得します。改善中か、低下中かを確認できます。

CI で AI の依存関係をチェック

HVTrust Gate は、GitHub Actions で同じ信頼性チェックを実行します。設定がなくても、requirements.txt、pyproject.toml、package.json、MCP クライアント設定を読み取り、依存している AI エージェントと MCP サーバーの HVTrust グレードを、これらのファイルを変更するプルリクエストにコメントします。

name: HVTrust
on: [pull_request]
permissions:
  contents: read
  pull-requests: write
jobs:
  trust:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v7
      - uses: YugantM/hvtrust-gate@v1

ローカルインストール

npm を使用する場合：

npm install -g hvtracker-mcp

PyPI を使用する場合：

python3 -m pip install hvtracker-mcp

MCP クライアント設定の例：

{
  "mcpServers": {
    "hvtracker": {
      "command": "hvtracker-mcp"
    }
  }
}

開発

python3 -m pip install -e ".[dev]"
python3 -m pytest
hvtracker-mcp

テスト時に別の HVTracker ベース URL を使用する場合：

HVTRACKER_BASE_URL=http://localhost:8080 hvtracker-mcp

レジストリへの公開

公式 MCP Registry マニフェストは server.json です。

mcp-publisher login github
mcp-publisher publish

GitHub Actions で、同じバージョンの npm、PyPI、GHCR パッケージが公開された後に、「Publish MCP Registry」ワークフローを実行してください。

サーバー名は次のとおりです。

io.github.YugantM/hvtracker-mcp

Claude Desktop 拡張機能

タグ付きリリースでは、manifest.json から Claude Desktop 用の .mcpb バンドルをビルドします。ローカルでビルドするには：

npm ci --omit=dev
npx @anthropic-ai/[email protected] pack

プライバシー

HVTracker MCP は、公開されている信頼性データを取得するため、ユーザーが指定した検索文字列またはサーバー識別子を https://hvtracker.net に送信します。API キーは不要で、ユーザーのシステムに書き込みは行いません。最新のデータと方法については HVTracker サイトを、リポジトリのプライバシーに関する注意事項については PRIVACY.md をご覧ください。