JinDaGe - halo-infinite-mcp MCP Details

article

README

🚀 开始使用 OpenSpartan Forerunner

Forerunner 是一个自定义构建的本地 MCP 服务器，借助它，您能通过任意 MCP 客户端连接到自己的 Halo Infinite 数据。

⚠️ 重要提示

此工具目前处于 alpha 阶段，因为 MCP 协议仍在开发中（Forerunner 也在同步完善）。使用时请注意风险。

🚀 快速开始

先决条件

.NET 9 SDK

操作步骤

下载最新版本。
将文件提取到本地设备。
更新您的 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 场比赛的结果如何？
我当前的护甲配置是什么？
当前交易所有什么物品正在出售？
我的当前职业等级是什么？

GIF 显示从 Claude Desktop 查询 Forerunner MCP 的职业等级数据

halo-infinite-mcp