Claudinho — live 2026 World Cup scores for your AI agent (stdio, npm)

@claudinho/mcp ⚽

コーディングエージェントがサッカーに関する質問に答えられるMCPサーバーです。ライブスコア、試合日程、順位表、共有用の試合カードを、ワールドカップ、プレミアリーグ、LALIGA、チャンピオンズリーグなど、応援している大会の情報を使って作成できます。 Claude Code、Cursor、Codex、Claude Desktop、Windsurf、Zed、VS Code、およびローカル（stdio）サーバーを実行するすべてのMCPクライアントで動作します。APIキーも登録もアカウントも不要です。

インストール

サーバーはnpxで実行するため、Node.js 22以降が必要です。これは実行可能な最も古いメジャーバージョンであり、セキュリティレベルを示すものではありません。Node 22または24系統のパッチ適用済みリリースを使用してください。

Claude Code

claude mcp add claudinho -- npx -y @claudinho/mcp

Codex CLI

codex mcp add claudinho -- npx -y @claudinho/mcp

Cursor、Claude Desktop、Windsurf、Zed、VS Code：クライアントのMCP設定に以下を追加してください（Cursorの場合は~/.cursor/mcp.jsonまたはプロジェクトの.cursor/mcp.json、Claude Desktopの場合は「設定」→「開発者」→「設定を編集」を選択し、その後再起動します）。一部のクライアント（VS Code、Zed）では、同じcommandとargsを独自のキーの下に記述します。クライアントのMCPドキュメントを参照してください。

{ "mcpServers": { "claudinho": { "command": "npx", "args": ["-y", "@claudinho/mcp"] } } }

Cursor CLIも使っていますか？ @claudinho/cliのclaudinho init cursorを実行すると、ライブスコアがステータスラインに表示され、貼り付け用の設定が出力されます。

最初の質問をする

サーバーが回答する大会は、一度に1つです。質問に大会名を含めるか、

「今日のチャンピオンズリーグの試合は？」 · 「プレミアリーグの順位表を見せて」 · 「アーセナルの次のチャンピオンズリーグの試合はいつ？」

CLIで大会を一度選択してから、次のように尋ねてください。

npx @claudinho/cli follow champions-league --team Arsenal

「今日の試合は？」 · 「ライブスコアを見せて」 · 「次の試合はいつ？」 · 「今日の試合の共有用カードを作って」

大会を指定しない場合、対象の大会が1つのツールは、選択方法を案内します。

ツール

すべてのツールは読み取り専用で、そのうち2つはネットワークに一切アクセスしません。

ツール	機能
get_today	呼び出し元のタイムゾーンで指定日（既定値：今日）の試合予定とライブスコアを取得します
get_live	現在進行中の試合を取得します
get_match	IDで1試合を取得します。試合中または終了した試合について、プロバイダーから送信されたゴールとカードを表示します
get_next_fixture	チーム名またはコード（Arsenal、ARS、Mexico、MEX）でチームの次の試合を取得します。teamを指定しない場合、サーバーのCLAUDINHO_TEAMを使用し、それがなければ、リクエストがそのチームの大会に関するものであれば、ユーザーがピン留めしたチーム（claudinho follow <alias> --team <name>）を使用します
get_standings	順位表を取得します。すべての表、またはキー（グループのアルファベット1文字、A1、A-B、LEAGUE）で指定した1つの表を取得できます
get_bracket	ワールドカップのノックアウト方式のトーナメント表を、ラウンド32から決勝まで取得します。省略可能なstage（R32、R16、QF、SF、3P、F）を指定すると、1つのラウンドに絞れます
get_share_snippet	試合、チームの次の試合、順位表、トーナメント表（bracket: true、knockoutStageは省略可能）、日付またはライブ情報のプレーンテキストカードを取得します。そのままユーザーに渡してください
get_market_signal	試合（matchId）、チームの現在または次の試合（team、MEXなどの3文字コード）、または日付について、ワールドカップの予測市場オッズを取得します。情報提供のみを目的としています
get_team	ワールドカップ参加国の名前またはコードから、FIFAコード、国旗、グループを取得します（オフライン）
list_competitions	対応している大会、各大会で使えるエイリアスと提供内容、および現在適用中の大会を取得します（オフライン）

get_teamを除くすべてのツールでは、competition（champions-leagueなどのエイリアス）を省略可能です。また、ほとんどのツールでは、tz、lang（en、es、pt、fr）、flavor（off、subtle、full）を指定できます。

リソース：standings://{group}、およびfixtures://{date}（バンドルされたワールドカップの試合日程）。 プロンプト：my_team（フォローしている大会における、あなたのチームの次の試合と順位）および tournament_today。

予測市場オッズ（ワールドカップ）

ワールドカップの試合では、信頼できるPolymarket市場がある場合、get_today、get_match、および試合、チームの次の試合、または日付のget_share_snippetカードに「どちらが有力か」を示す短い行が追加されます。また、get_market_signalは単独で市場情報を取得します。**情報提供のみを目的としており、賭けの助言ではありません。**Polymarketへの帰属を明記した、市場が示唆するパーセンテージのみを表示し、リンクや取引の呼びかけは行いません。終了した試合には表示されません。サーバーのenvでCLAUDINHO_MARKETS=offを指定すると、この短い行がオフになります。get_market_signalは引き続き応答します。

実況

ツールのテキスト内の試合行の末尾には、読み手の言語による短い実況（— ¡GOOOOL!）が付きます。チーム独自の掛け声がある場合は、それが使われます（メキシコの¿Y si sí?、Pumasの¡Goya!、ArsenalのCOYG!）。延期または中止された試合には、どちらも付きません。実況は構造化データには表示されません。サーバーのenvでCLAUDINHO_FLAVOR=subtleまたはoffを指定するか、呼び出しごとにflavorを指定すると、実況を控えめにできます。

エージェント開発者向け詳細

大会の選択。 リクエストの大会は、competition 引数、サーバーの CLAUDINHO_COMPETITION、保存済みの claudinho follow <alias> の選択の順に決まります。認識されない値が指定された場合、エイリアスの一覧を示すツールエラーになります。いずれも指定されていない場合、すべての大会回答ツールは空のデータ構造とともに noCompetition: true および competition: null を返し、何をすればよいかを説明する文を添えます。list_competitions は current: null を返します。

すべての回答に含まれる内容。 人が読めるテキストと、各ツールの宣言済み outputSchema に照らして検証された構造化コンテンツが含まれます。テキストの冒頭には対象の大会が示され（シェアカードではタイトルに表示されます）、構造化コンテンツでは competition として示されます。2つのツールは例外です。get_team は大会にかかわらずワールドカップの各国代表チームを読み取るため、competition は含まれません。また、list_competitions は、適用中の大会をテキストの末尾とデータ内の current として示します。

不完全な回答。 プロバイダーから読み取れないレコードが送られてきた場合、get_today、get_live、get_match、get_next_fixture、get_bracket、get_market_signal、get_share_snippet は、表示内容の前にその旨を伝え、partial を含めます（判明している場合は、除外されたレコード数を示す omitted も含みます）。空の回答は、何も存在しないという意味ではなく、何も読み取れなかったという意味です。特に、次の試合が見つからなくても、チームが敗退したことを意味するわけではありません。

クラブの大会。 get_next_fixture と get_match は昨日から14日後までを検索します。horizon または window を含む空の回答は、その期間についてのものです。同じ名前に該当するチームが複数ある場合は、candidates として返されます。シーズンの切り替わり期間中は、get_today、get_live、get_next_fixture、get_match に betweenEditions が含まれます。get_bracket は、ノックアウト方式の試合がないリーグのシーズン（Premier League、LALIGA）には inapplicable を返し、ワールドカップ以外のすべての大会には unsupported を返します。クラブには flag がありません。試合の stage は、リーグのシーズンでは REGULAR、カップのリーグフェーズでは LEAGUE、プレーオフでは PO、それ以外では OTHER となり、プロバイダー独自の表記が stageLabel に入ります。

マーケット。 get_today、get_match、および試合、チームの次の試合、日付、ライブ試合の get_share_snippet カードには marketComplete が含まれます（テーブルカードやブラケットカードには含まれません）。get_market_signal には complete が含まれます。false は、任意のマーケット情報の取得が完了しなかったことを意味し、「シグナルがない」こととは異なります。テキストとシェアカードにもその旨が示されます。CLAUDINHO_MARKETS_SOURCE=fake を設定すると、ネットワーク接続を使わないプレビューが明確なラベル付きで表示されます。

プロセス。 標準出力には MCP プロトコルのみが出力され、診断情報は標準エラー出力に送られます。サーバーの env に CLAUDINHO_DEBUG=1 を設定すると、データプロバイダーのエラーが標準エラー出力に表示されます。

動作の仕組み

ワールドカップの全104試合はパッケージに同梱されています。それ以外の大会の試合日程と、すべてのライブスコアは、ESPNの公開スコアボードから取得されます（その回答にはESPNの名前が記載されます）。ワールドカップのマーケットオッズは、Polymarketの公開データから取得されます。サーバーはキャッシュをメモリ内にのみ保持します。

プライバシー

アカウント、テレメトリー、分析、追跡はなく、Claudinho サーバーもありません。サーバーは、あなたに関する情報を付けずに、ESPN（ワールドカップのオッズについては Polymarket）に公開データをリクエストします。ただし、これらのサービスには、他のウェブリクエストと同様に、IPアドレスなどの標準的なリクエストメタデータが表示されます。ディスクには何も書き込みません。ポリシー全文： PRIVACY.md。

ライセンス

MIT © 2026 Arturo Garrido · ソースと課題

独立したファンプロジェクトです。FIFA、各大陸連盟、リーグ、クラブ、Anthropic とは関係ありません。

試合を見ながら作りました。 #VibingLaVidaLoca ⚽