NHL Go

An unofficial collection of NHL data tools, written in Go 🏒

Features

A client wrapper around the NHL web api, based on the reference spec defined here.

See roadmap.md for more details.

See /examples for usage.

./nhl -player -name "Miro Heiskanen"

Exposes NHL API data via the Model Context Protocol, allowing for easy integration with LLMs.

Build the nhl-mcp binary:

cd ./mcp && go build -o nhl-mcp

Add path to the nhl-mcp binary to your claude_desktop_config.json file:

"nhl": {
  "command": "/path/to/nhl-mcp"
}

Go version >= 1.23

Create a fork of this repository, then clone it.

git clone https://github.com/carsonjones/nhl-go.git
cd nhl-go

Build the nhl and nhl-mcp binaries:

go build -o nhl && cd ./mcp && go build -o ../nhl-mcp && cd ../

Debug MCP server:

npx @modelcontextprotocol/inspector ./nhl-mcp

go test -v './...'

HOCKEY!!!