使用说明

项目简介

NHL Go 是一个非官方的 NHL 数据工具集合,包含 API 客户端、CLI 和 MCP 服务器。其中 MCP 服务器部分旨在通过 Model Context Protocol (MCP) 将 NHL 数据以标准化的方式提供给 LLM 客户端,方便 LLM 应用集成 NHL 数据。

主要功能点

  • 资源 (Resources): 通过 NHL API 获取并托管 NHL 赛事、球队和球员等数据资源。
  • 工具 (Tools): 提供一系列预定义的工具,允许 LLM 客户端调用以查询 NHL 数据,例如:
    • 'nhl-slate': 获取指定日期的比赛日程。
    • 'nhl-player': 查询球员信息和统计数据。
    • 'nhl-standings': 获取 NHL 排行榜数据 (联盟、分区或联盟)。
    • 'nhl-roster': 获取球队阵容名单。
    • 'nhl-schedule': 获取球队赛季赛程。
    • 'nhl-leaders': 获取 NHL 联盟数据领导者(得分王、射手榜等)。
  • Prompt 模板 (Prompts): 虽然仓库信息中没有明确提及 Prompt 模板,但 MCP 服务器的工具本身就为 LLM 提供了结构化的数据访问能力,可以结合 Prompt 模板使用。

安装步骤

  1. 确保已安装 Go 语言环境 (版本 >= 1.23)。
  2. 克隆仓库到本地:
    git clone https://github.com/carsonjones/nhl-go.git
  3. 进入 'mcp' 目录:
    cd nhl-go/mcp
  4. 构建 'nhl-mcp' 服务器程序:
    go build -o nhl-mcp
  5. 将生成的可执行文件 'nhl-mcp' 的路径添加到 MCP 客户端的配置文件中。

服务器配置

对于 MCP 客户端(例如 Claude 客户端),需要在其配置文件 'claude_desktop_config.json' 中添加 NHL MCP 服务器的配置。以下是一个示例配置,请根据实际 'nhl-mcp' 程序的路径进行修改:

{
  "servers": {
    "nhl": {
      "serverName": "nhl",  // 服务器名称,可自定义
      "command": "/path/to/nhl-go/nhl-mcp", // nhl-mcp 可执行文件的绝对路径
      "args": [] // 启动参数,本例中不需要参数
    }
  }
}

配置参数说明:

  • 'serverName': MCP 服务器的名称,客户端用此名称来引用该服务器。
  • 'command': 启动 MCP 服务器的命令,这里是 'nhl-mcp' 可执行文件的路径。
  • 'args': 启动命令的参数,本例中 'nhl-mcp' 不需要额外的启动参数,所以为空数组。

基本使用方法

配置完成后,在 MCP 客户端中,您可以通过工具调用来访问 NHL 数据。例如,在 Claude 客户端中,可以使用以下方式调用工具:

{
  "tool_calls": [
    {
      "server": "nhl",  // 使用上面配置的 serverName
      "tool": "nhl-slate", // 工具名称
      "arguments": {
        "date": "2024-03-15" // 工具参数,例如查询 2024-03-15 的比赛日程
      }
    }
  ]
}

您可以使用不同的工具名称和参数来查询不同的 NHL 数据,具体工具和参数请参考 主要功能点 部分。

信息

分类

网页与API