FFBB MCP Server

Serveur MCP (Model Context Protocol) pour accéder aux données de la Fédération Française de Basketball (FFBB) depuis ton IA.

Fonctionnalités

Aucune clé API requise — les tokens sont récupérés automatiquement depuis l'API publique FFBB.

Installation

# Créer un environnement virtuel
python -m venv .venv
source .venv/bin/activate

# Installer le serveur
pip install -e ".[dev]"

Lancement

# Mode développement avec MCP Inspector
npx @modelcontextprotocol/inspector python -m ffbb_mcp

# Mode direct (stdio pour intégration MCP)
python -m ffbb_mcp

Configuration dans Gemini CLI

Ajouter dans ~/.gemini/settings.json :

{
  "mcpServers": {
    "ffbb": {
      "command": "python",
      "args": ["-m", "ffbb_mcp"],
      "cwd": "/chemin/vers/FFBB MCP server"
    }
  }
}

Configuration dans Claude Desktop

Ajouter dans ~/Library/Application Support/Claude/claude_desktop_config.json :

{
  "mcpServers": {
    "ffbb": {
      "command": "/chemin/vers/.venv/bin/python",
      "args": ["-m", "ffbb_mcp"],
      "cwd": "/chemin/vers/FFBB MCP server"
    }
  }
}

Tests

pytest tests/ -v

Exemples de questions à poser à ton IA

• "Quels matchs de basketball sont en cours en ce moment ?"

• "Cherche les clubs de basketball à Lyon"

• "Donne-moi le calendrier du championnat Nationale 1"

• "Où se joue le prochain match de l'ASVEL ?"

• "Quel est le classement de la poule A du championnat Pro B ?"

Source des données

Librairie ffbb-api-client-v2 — Apache 2.0