OpenSpartan Forerunner

Forerunner 是一个定制的本地 MCP 服务，可让你通过正在使用的任意 MCP 客户端连接到 Halo Infinite 数据。

警告

目前这还是一个Alpha 质量的工具，因为 MCP 协议仍在完善中（Forerunner 也一样）。前方有龙。

前提条件

• .NET 9 SDK

开始使用

1. 下载最新版本。
2. 在本地解压软件包。
3. 更新 MCP 客户端配置，将其指向 OpenSpartan.Forerunner.MCP.exe，并使用 dotnet 命令作为引导工具。

配置示例

Visual Studio Code

重要

你需要安装 Visual Studio Code Insiders 才能使用 MCP。

"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 Account（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 生涯等级（或级别），以及距离最高级别（英雄）的进度。玩家每场对战都会获得经验值，因此可能会想知道还要多久才能达到英雄等级。

运行

你可以提问，例如：

1. 我最近匹配游戏的统计数据是什么？
2. 我最近 10 场对战的结果是什么？
3. 我当前的护甲配置是什么？
4. 兑换商店目前在促销哪些商品？
5. 我当前的生涯等级是什么？