使用说明
项目简介
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 模板使用。
安装步骤
- 确保已安装 Go 语言环境 (版本 >= 1.23)。
- 克隆仓库到本地:
git clone https://github.com/carsonjones/nhl-go.git - 进入 'mcp' 目录:
cd nhl-go/mcp - 构建 'nhl-mcp' 服务器程序:
go build -o nhl-mcp - 将生成的可执行文件 '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