Ball Ranks Fantasy Sports

Ball Ranks プラグイン

Ball Ranks は、読み取り専用のリモート MCP サーバーを通じて、公開済みのファンタジーバスケットボールおよびフットボールのランキングと選手予測を提供します。

このリポジトリには、ChatGPT、Codex、Claude、Google Antigravity、Gemini CLI、Grok Build、Muse Code、その他のエージェントプラグインや MCP 対応クライアント向けに、同じ稼働中のサーバーがパッケージ化されています。初期の MCP 機能には 4 つのツールが含まれています。クライアントは稼働中のツール一覧を取得するため、Ball Ranks はサーバー URL を変更せずに機能を追加できます。

サーバー

• MCP エンドポイント：https://ballranks.com/api/mcp
• 開発者向けドキュメント：https://ballranks.com/developers
• OpenAPI：https://ballranks.com/openapi.json
• サポート：https://ballranks.com/support
• プライバシー：https://ballranks.com/privacy
• 利用規約：https://ballranks.com/terms

インストール

エージェントプラグインに対応しているクライアントでは、このリポジトリを直接インストールできます。プラットフォーム固有のマニフェストも含まれています。

• plugin.json および mcp.json：エージェントプラグイン、ChatGPT、Codex
• server.json：公式 MCP レジストリ
• .codex-plugin/plugin.json：Codex のローカルプラグイン互換性
• .claude-plugin/plugin.json および .mcp.json：Claude Code、Grok Build
• antigravity-plugin/：Google Antigravity 2.0、CLI、IDE
• gemini-extension.json および GEMINI.md：エンタープライズ向けおよび有料 API キーを使う Gemini CLI のインストール

このリポジトリに API キーは保存されていません。匿名の Model Zero アクセスでは、リクエスト上限が低くなります。アカウント単位の上限を利用するための Ball Ranks API キーは、https://ballranks.com/account#developer-access で作成できます。クライアントは認証情報を安全に保管する必要があります。

Google Antigravity

Google は 2026 年 6 月 18 日に、無料ユーザーおよび Google One の Gemini CLI ユーザーを Antigravity CLI に移行しました。このリポジトリをクローンし、専用ディレクトリからネイティブパッケージをインストールします。

agy plugin install ./antigravity-plugin

Antigravity CLI 内で実行する場合、同等のコマンドは次のとおりです。

/plugin install ./antigravity-plugin

このパッケージは ball-ranks としてインストールされ、serverUrl を介して本番 MCP エンドポイントに接続し、Ball Ranks に特化したスキルが含まれています。agy plugin list を実行し、/mcp を開いて、プラグインとサーバーが読み込まれたことを確認してください。

ワークスペースのみの Antigravity 2.0 または IDE へのインストールでは、パッケージディレクトリを .agents/plugins/ball-ranks/ にコピーしてください。グローバルインストールでは、~/.gemini/config/plugins/ball-ranks/ にコピーしてください。

マーケットプレイスへの公開は、パッケージとは別に行います。Google は現在、公開者に Antigravity Marketplace への関心表明フォームへの記入を求めています。

Gemini CLI（エンタープライズ向けおよび API キーを使うインストール）

公開リポジトリから直接インストールします。

gemini extensions install https://github.com/Ollynov/ball-ranks-plugin

インストール後に Gemini CLI を再起動し、/extensions list と /mcp を実行して、ball-ranks とその稼働中のツールが利用可能であることを確認してください。GEMINI.md には、ツールの選択方法と応答に関する簡潔なガイダンスが記載されています。このパッケージは、エンタープライズ向けおよび有料 API キーを使う Gemini CLI のインストール向けに引き続き提供されます。

公開ギャラリーはリポジトリを自動的に検出します。このリポジトリは公開されており、gemini-cli-extension GitHub トピックが設定され、リポジトリのルートに gemini-extension.json が配置されています。ギャラリーへの個別の申請は不要です。

現在のツール

• get_week_rankings
• get_season_rankings
• get_player_rankings
• get_player_projections

すべてのツールは読み取り専用で、構造化コンテンツと正規の sourceUrl を返します。

レビュー資料

review/review-cases.json には、plugin.json からインポートされたものと同じ、肯定的なケース 5 件と否定的なケース 3 件が含まれています。review/demo-script.md は、共有のウォークスルー計画です。review/openai-submission.md には、残っているダッシュボード作業とツールアノテーションの根拠が記録されています。ツールの契約を変更した後は、本番環境に対してケースを実行してください。

OpenAI 提出用 ZIP をビルドする

クリーンでコミット済みのチェックアウトから ./scripts/build-openai-submission.sh を実行します。このスクリプトはパッケージを検証し、現在のコミットから dist/ball-ranks-openai-<version>.zip を作成します。同じコミットから再ビルドすると、同じ SHA-256 ダイジェストが生成されます。

ZIP に含まれるのは、移植可能なマニフェスト、リモート MCP 設定、オンボーディングスキル、および参照されている正方形のアイコンのみです。プラットフォーム互換性マニフェスト、レビュー用メモ、リポジトリのドキュメント、スクリーンショットは意図的に除外されています。

サポート

[email protected] にメールを送るか、https://ballranks.com/support にアクセスしてください。サポートへの問い合わせに、パスワード、サインイン Cookie、または API キー全体を記載しないでください。

ライセンス

このリポジトリのパッケージングファイルとスキルの手順は、MIT ライセンスの下で提供されています。Ball Ranks のデータとサービスには、引き続き Ball Ranks 利用規約が適用されます。