OpenSpartan Forerunner

OpenSpartan Forerunner

site icon
2025.03.27 3
C#游戏数据服务Halo Infinite 工具娱乐功能
OpenSpartan Forerunner 是一个本地 MCP 服务器,用于连接 Halo Infinite 游戏数据。它允许用户通过 MCP 客户端访问游戏数据,如玩家服务记录、最新比赛统计、装备配置等。目前处于 alpha 阶段,功能正在不断完善中。
View on GitHub

Overview

基本能力

产品定位

OpenSpartan Forerunner 是一个本地 MCP 服务器,专为 Halo Infinite 游戏设计,用于连接和访问游戏数据。

核心功能

  • 提供 Halo Infinite REST API 的端点列表
  • 获取玩家服务记录
  • 查询玩家最新比赛统计
  • 列出 Halo Infinite 交易所可用物品
  • 获取玩家当前装备配置
  • 查询玩家当前职业等级

适用场景

  • 玩家想要查看自己的游戏统计数据
  • 玩家想要了解最新的比赛结果
  • 玩家想要查看当前的装备配置
  • 玩家想要了解交易所中的可用物品
  • 玩家想要跟踪自己的职业等级进度

工具列表

工具名称 描述
opsp_api_endpoints 返回 Halo Infinite REST API 所有可用端点的 JSON 格式列表
opsp_my_service_record 返回当前认证玩家的完整 Halo Infinite 玩家服务记录
opsp_my_latest_matches 返回玩家最新 Halo Infinite 比赛的统计数据
opsp_exchange_list 列出当前 Halo Infinite 交易所中所有可用物品
opsp_my_gear_configuration 返回认证用户的 Halo Infinite 自定义装备及其图片
opsp_my_career_rank 返回玩家当前的 Halo Infinite 职业等级

常见问题解答

  • 这是一个 alpha 质量的工具,MCP 协议正在完善中
  • 需要 Visual Studio Code Insiders 以获得 MCP 支持
  • 认证过程中需要 Microsoft 账户 (MSA) 凭证
  • 所有凭证仅用于与 Xbox 和 Halo Infinite REST API 通信,不会离开用户机器

使用教程

使用依赖

安装教程

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

Visual Studio Code 配置示例

"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) 凭证
  • 凭证将本地缓存,仅用于与 Xbox 和 Halo Infinite REST API 通信
  • 可以查询的问题示例:
  • 我的最新比赛统计数据是什么?
  • 我最近10场比赛的结果是什么?
  • 我当前的装甲配置是什么?
  • 交易所目前有哪些物品在售?
  • 我当前的职业等级是什么?

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。