🚀 开始使用 OpenSpartan Forerunner
Forerunner 是一个自定义构建的本地 MCP 服务器，借助它，您能通过任意 MCP 客户端连接到自己的 Halo Infinite 数据。
⚠️ 重要提示
此工具目前处于 alpha 阶段，因为 MCP 协议仍在开发中（Forerunner 也在同步完善）。使用时请注意风险。
🚀 快速开始
先决条件
操作步骤
- 下载 最新版本。
- 将文件提取到本地设备。
- 更新您的 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 帐户（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 战斗的统计信息，包括所有类型的游戏（例如匹配游戏、自定义游戏和局域网游戏）。所有返回的比赛日期均为 UTC 格式。 |
opsp_exchange_list |
列出当前在 Halo Infinite 交易所可用的所有物品。 |
opsp_my_gear_configuration |
返回 Halo Infinite 自定义设置及其图像，适用于已认证用户。 |
opsp_my_career_rank |
返回玩家的当前 Halo Infinite 职业等级（或级别）和晋升到最高级别（英雄）的进度。玩家通过每场比赛获得经验，并可能想知道晋升为英雄还需要多长时间。 |
运行
以下是一些您可以提出的问题：
- 我最近的匹配游戏统计信息是什么？
- 我最近 10 场比赛的结果如何？
- 我当前的护甲配置是什么？
- 当前交易所有什么物品正在出售？
- 我的当前职业等级是什么？