OpenSpartan Forerunner

<div align="center"> <img src="media/forerunner-logo.webp" width="200" height="200"> <h1>OpenSpartan Forerunner</h1> <p> <b>连接你到 Halo Infinite 数据的 MCP 服务器。</b> </p> <br> <br> <br> </div>

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

[!WARNING] 目前这是一个 alpha 质量 的工具，因为 MCP 协议正在完善中（Forerunner 也是如此）。这里有恶龙。

前提条件

• .NET 9 SDK

开始使用

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

示例配置

Visual Studio Code

[!IMPORTANT] 你需要安装 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 帐户 (MSA) 凭据。 这是你用于 Halo Infinite 的 Xbox Live 帐户。 在此过程中，令牌（或任何其他凭据工件）永远不会离开你的机器。 它们缓存在本地，然后专门用于与 Xbox 和 Halo Infinite REST API 通信 - 仅此而已。

支持的工具

[!IMPORTANT] 我正在不断添加新工具。 此表将在引入新工具时更新。

工具名称	描述
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. 我当前的职业等级是什么？