OpenSpartan Forerunner

Forerunner は、使用している MCP クライアントを通じて Halo Infinite のデータに接続できる、カスタム構築されたローカル MCP サーバーです。

警告

現時点では、MCP プロトコル（および Forerunner）の開発が進行中のため、このツールはアルファ品質です。ここには危険が潜んでいます。

前提条件

• .NET 9 SDK

はじめに

1. 最新リリースをダウンロードします。
2. パッケージをローカルに展開します。
3. MCP クライアントの設定を更新し、ブートストラップツールとして dotnet コマンドを使用して OpenSpartan.Forerunner.MCP.exe を指定します。

設定例

Visual Studio Code

重要

MCP をサポートするには、Visual Studio Code Insiders をインストールする必要があります。

"mcp": {
    "inputs": [],
    "servers": {
        "mcp-halo-infinite": {
            "command": "PATH_TO_YOUR_OpenSpartan.Forerunner.MCP.exe",
            "args": [],
            "env": {}
        }
    }
}

Claude Desktop

"mcpServers": {
    "mcp-halo-infinite": {
        "command": "PATH_TO_YOUR_OpenSpartan.Forerunner.MCP.exe",
        "args": [],
        "env": {}
    }
}

認証

MCP クライアントにツールを追加すると、Microsoft アカウント（MSA）の認証情報を求められます。これは、Halo Infinite で使用している Xbox Live アカウントです。このプロセス中、トークン（またはその他の認証情報）がマシンの外部に送信されることはありません。これらはローカルにキャッシュされ、Xbox と Halo Infinite の REST API との通信にのみ使用されます。それ以外には使用されません。

サポート対象のツール

重要

新しいツールを継続的に追加しています。新しいツールが追加されるたびに、この表を更新します。

ツール名	説明
opsp_api_endpoints	Halo Infinite REST API で利用可能なすべてのエンドポイントの一覧を JSON 形式で返します。
opsp_my_service_record	認証済みプレイヤーの、マッチメイキングゲームにおける Halo Infinite の完全なプレイヤー戦績を返します。このツールにはキャリアランクは含まれません。
opsp_my_latest_matches	プレイヤーの Halo Infinite の最新マッチの統計情報を返します。マッチメイキングゲーム、カスタムゲーム、LAN ゲームなど、すべてのマッチタイプが含まれます。マッチの日付はすべて UTC で返されます。
opsp_exchange_list	Halo Infinite のエクスチェンジで現在入手可能なアイテムを一覧表示します。
opsp_my_gear_configuration	認証済みユーザーの Halo Infinite のカスタマイズと、その画像を返します。
opsp_my_career_rank	プレイヤーの現在の Halo Infinite のキャリアランク（またはレベル）と、最高レベル（Hero）までの進捗を返します。プレイヤーは各マッチで経験値を獲得するため、Hero ランクまでどれくらいかかるかを確認できます。

実行方法

次のような質問ができます。

1. マッチメイキングゲームでの最新の統計情報は？
2. 直近 10 マッチの結果は？
3. 現在のアーマー構成は？
4. 現在 The Exchange で販売されているものは？
5. 現在のキャリアランクは？