BGG MCP : Serveur API BoardGameGeek MCP

[!AVERTISSEMENT]
Ce projet est en cours de développement, il faut donc s'attendre à ce que les outils changent.

BGG MCP fournit un accès à l'API BoardGameGeek à travers le Model Context Protocol, permettant la récupération et le filtrage des données de jeux de société, des collections d'utilisateurs et des profils. Le serveur est implémenté en Go, en utilisant la bibliothèque GoGeek, ce qui permet d'assurer des interactions API robustes.

Exemple

Outils

• Détails du jeu (recherche d'un jeu par son nom, renvoie actuellement la meilleure correspondance)
• Collection (recherche et filtrage de la collection d'un utilisateur)
• Hottness (obtenir le hotness actuel de BGG)
• Utilisateur (recherche les détails d'un utilisateur par son nom d'utilisateur)

Feuille de route

• Détails d'un jeu spécifique (par nom)
• Collection (+ filtres)
• Jeux en vogue
• Détails de l'utilisateur
• Recherche générale
• Jeux recommandés

Configuration

Vous avez deux options pour l'installation, la plus simple étant d'utiliser l'intégration de Smithery.

A) Installation via Smithery

Pour installer bgg-mcp pour Claude Desktop automatiquement via Smithery:

npx -y @smithery/cli install @kkjdaniel/bgg-mcp --client claude

B) Installation manuelle

1. Installer Go

Vous aurez besoin d'avoir Go installé sur votre système pour construire le binaire. Il peut être facilement téléchargé et installé ici, ou vous pouvez utiliser le gestionnaire de paquets que vous préférez comme Brew.

2. Construire

Le projet inclut un Makefile pour simplifier la construction et la gestion du binaire.

# Construire l'application (la sortie va dans build/bgg-mcp) make build # Nettoyer les artefacts de construction make clean # Nettoyer et construire make all

Ou vous pouvez simplement le construire directement avec Go...

go build -o build/bgg-mcp

3. Ajouter la configuration MCP

Dans settings.json (VS Code / Cursor) ou claude_desktop_config.json ajoutez ce qui suit à votre liste de serveurs, en le pointant vers le binaire que vous avez créé plus tôt, une fois que vous chargez votre outil AI, vous devriez voir les outils fournis par le serveur connecté :

"bgg" : {"command" : "path/to/build/bgg-mcp", "args" : [] }

Vous trouverez plus de détails sur la configuration de Claude ici.

Utilisation du Makefile

Le projet inclut un Makefile pour simplifier la construction et la gestion du binaire.

# Construire l'application (la sortie va dans build/bgg-mcp) make build # Nettoyer les artefacts de construction make clean # Nettoyer et construire make all