使用说明

项目简介

OpenSpartan Forerunner 是一个专为 Halo Infinite 设计的本地 Model Context Protocol (MCP) 服务器。它允许你通过任何 MCP 客户端连接到你的 Halo Infinite 游戏数据。作为一个桥梁，Forerunner 将 Halo Infinite 的数据以标准化的 MCP 协议格式提供给 LLM，使得 LLM 应用能够理解和利用游戏内的上下文信息。

主要功能点

数据访问 (Resources): 提供对本地缓存的 Halo Infinite 游戏内图片资源的访问能力。允许客户端通过资源 URI 获取图片，例如玩家的装备、物品图标等。
工具 (Tools): 集成了一系列预定义的工具，允许 LLM 客户端调用以获取特定的 Halo Infinite 数据，包括：
- 'opsp_api_endpoints': 获取 Halo Infinite REST API 的所有可用端点列表。
- 'opsp_my_service_record': 获取当前认证玩家在匹配游戏中的完整服务记录。
- 'opsp_my_latest_matches': 获取玩家最新的 Halo Infinite 比赛统计数据，包括匹配赛、自定义赛和局域网游戏。
- 'opsp_exchange_list': 列出 Halo Infinite 交易所中当前可用的所有物品。
- 'opsp_my_gear_configuration': 获取当前认证用户的 Halo Infinite 装备配置信息及其图片。
- 'opsp_my_career_rank': 获取玩家当前的 Halo Infinite 职业等级和升级进度。

安装步骤

安装 .NET 9 SDK: 确保你的系统上安装了 .NET 9 SDK。你可以从官方网站下载并安装。
下载最新 Release: 访问 Releases 页面下载最新版本的 'OpenSpartan Forerunner' 压缩包。
解压文件: 将下载的压缩包解压到本地的某个目录。

服务器配置

MCP 服务器需要配置在 MCP 客户端中才能使用。以下是针对不同 MCP 客户端的配置示例。你需要将 'PATH_TO_YOUR_OpenSpartan.Forerunner.MCP.exe' 替换为你解压后的 'OpenSpartan.Forerunner.MCP.exe' 文件的实际路径。

Visual Studio Code (Insiders)

"mcp": {
    "inputs": [],
    "servers": {
        "mcp-halo-infinite": {
            "command": "PATH_TO_YOUR_OpenSpartan.Forerunner.MCP.exe",  //  替换为 OpenSpartan.Forerunner.MCP.exe 的路径
            "args": [],  //  启动参数，这里为空
            "env": {}   //  环境变量，这里为空
        }
    }
}

Claude Desktop

"mcpServers": {
    "mcp-halo-infinite": {
        "command": "PATH_TO_YOUR_OpenSpartan.Forerunner.MCP.exe",  // 替换为 OpenSpartan.Forerunner.MCP.exe 的路径
        "args": [],  // 启动参数，这里为空
        "env": {}   // 环境变量，这里为空
    }
}

基本使用方法

启动 MCP 服务器: 在 MCP 客户端中配置好服务器信息后，启动 MCP 服务器。通常 MCP 客户端会自动启动配置的服务器。
身份验证: 首次使用时，服务器会提示你进行 Microsoft 账户 (MSA) 身份验证。这是你的 Xbox Live 账户，用于访问 Halo Infinite 数据。按照提示完成身份验证流程。
在 LLM 中使用工具和资源: 在支持 MCP 协议的 LLM 应用中，你可以通过工具名称（例如 'opsp_my_career_rank'）调用工具，或通过资源 URI（例如 'opsp://resources/localimage/{image_path}'）访问资源。你可以向 LLM 提出问题，例如：
- "What is my current career rank in Halo Infinite?" (LLM 可能会调用 'opsp_my_career_rank' 工具)
- "Show me my latest match stats." (LLM 可能会调用 'opsp_my_latest_matches' 工具)
- "What items are currently on sale in the Exchange?" (LLM 可能会调用 'opsp_exchange_list' 工具)

注意

该项目目前处于 Alpha 阶段，功能和稳定性仍在开发中。
服务器需要 Microsoft 账户进行身份验证才能访问 Halo Infinite 数据。
首次运行可能需要一些时间下载必要的游戏资源和缓存图片。

关键词

使用说明

信息