NHL Go
An unofficial collection of NHL data tools, written in Go 🏒
Features
NHL API Client
A client wrapper around the NHL web api, based on the reference spec defined here.
Supported Functionality
- Teams (Rosters)
- Players (Stats)
- Schedule (by date, by team)
- Standings
See roadmap.md for more details.
NHL CLI
See /examples for usage.
./nhl -player -name "Miro Heiskanen"
NHL MCP Server
Exposes NHL API data via the Model Context Protocol, allowing for easy integration with LLMs.
Installation
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"
}
Local Development
Prerequisites
Go version >= 1.23
Installation
Create a fork of this repository, then clone it.
git clone https://github.com/carsonjones/nhl-go.git
cd nhl-go
Commands
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
Testing
go test -v './...'
HOCKEY!!!