BGG MCP provides access to the BoardGameGeek API through the Model Context Protocol, enabling retrieval and filtering of board game data, user collections, and profiles.
[!WARNING]
This project is under active developmennt, therefore expect tooling to change.
BGG MCP provides access to the BoardGameGeek API through the Model Context Protocol, enabling retrieval and filtering of board game data, user collections, and profiles. The server is implemented in Go, using the GoGeek library, which helps ensure robust API interactions.
You have two options for setting up, the easiest is to use the integration of Smithery.
To install bgg-mcp for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @kkjdaniel/bgg-mcp --client claude
You will need to have Go installed on your system to build binary. This can be easily downloaded and setup here, or you can use the package manager that you prefer such as Brew.
The project includes a Makefile to simplify building and managing the binary.
## Build the application (output goes to build/bgg-mcp)
make build
## Clean build artifacts
make clean
## Both clean and build
make all
Or you can simply build it directly with Go…
go build -o build/bgg-mcp
In the settings.json
(VS Code / Cursor) or claude_desktop_config.json
add the following to your list of servers, pointing it to the binary you created earlier, once you load up your AI tool you should see the tools provided by the server connected:
"bgg": {
"command": "path/to/build/bgg-mcp",
"args": []
}
More details for configuring Claude can be found here.
The project includes a Makefile to simplify building and managing the binary.
## Build the application (output goes to build/bgg-mcp)
make build
## Clean build artifacts
make clean
## Both clean and build
make all