光环无限MCP服务器

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

先锋是一个自定义构建的本地MCP服务器，允许您通过任何使用的MCP客户端连接到您的Halo Infinite数据。

[!警告] 这是一个Alpha质量工具，因为MCP协议正在完善中（先锋也是如此）。这里充满了未知的风险。

预备条件

• .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账户（MSA）凭据。这是您用于Halo Infinite的Xbox Live账户。在此过程中，没有任何令牌（或其他凭据信息）离开您的机器。它们被缓存到本地，并仅用于与Xbox和Halo Infinite REST API通信——其他用途均不适用。

支持的工具

[!重要] 我一直在添加新的工具。随着新工具的引入，此表将进行更新。

工具名称	描述
opsp_api_endpoints	返回一个JSON格式的所有可用端点列表，这些端点存在于Halo Infinite REST API表面。
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生涯等级（或级别）以及达到最高等级（英雄）的进度。玩家每场比赛都会获得经验值，可能想知道距离英雄等级还有多远。

运行

您可以询问的一些问题：

1. 我最近的匹配游戏统计数据是什么？
2. 我最后10场比赛的结果是什么？
3. 我当前的护甲配置是什么？
4. 当前有哪些物品在交易所出售？
5. 我当前的生涯等级是什么？