🏀 FFBB MCP Server

Le basket français officiel, directement dans vos assistants IA.

Serveur MCP pour consulter calendriers, classements, bilans, résultats et scores live de la FFBB.

🌐 Site · 🧩 Extension VS Code · 📚 Documentation · 💬 Support

⚡ Démarrage express (< 2 min)

https://ffbb.desimone.fr/mcp

Puis posez vos questions en langage naturel :

« Quel est le prochain match des U15 de mon club ? » « Donne-moi le classement de la poule et le dernier résultat. » « Y a-t-il des matchs en direct ce soir ? »

👉 Voir la section Installation pour brancher l'endpoint sur VS Code, Claude, Cursor, etc.

Related MCP server: SportScore

✨ Fonctionnalités

• 🗓️ Calendriers & résultats — matchs passés et à venir, par club ou par équipe.

• 🏆 Classements — poules complètes avec points, différentiel et forme.

• 📊 Bilans agrégés — toutes phases confondues en un seul appel.

• 🔴 Scores live — matchs en cours, mis à jour toutes les 30 s.

• 🔎 Recherche universelle — clubs, compétitions, salles, engagements.

• 🚀 Optimisé pour les LLM — réponses agrégées et cache TTL pour réduire le contexte et le nombre d'appels.

🚀 Installation

VS Code / GitHub Copilot

Option recommandée — installer l'extension FFBB Basketball MCP depuis les releases, puis ouvrir Copilot Chat en mode agent.

Alternative sans extension — ➕ Installer FFBB MCP en un clic

Claude Desktop

1. Ouvrez les Paramètres de Claude, puis Connecteurs (ou Plugins).

2. Cliquez sur Ajouter un connecteur personnalisé.

3. Renseignez l'URL publique https://ffbb.desimone.fr/mcp et validez.

Claude Desktop n'accepte que le transport stdio local : on utilise donc le bridge SSE officiel via npx.

{
  "mcpServers": {
    "ffbb": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/client-sse", "https://ffbb.desimone.fr/mcp"]
    }
  }
}

Cursor / autres clients MCP

Configurez un serveur MCP distant :

Google Antigravity

Configurez directement l'URL distante dans mcp_config.json via la directive native serverUrl :

{
  "mcpServers": {
    "ffbb_mcp": {
      "serverUrl": "https://ffbb.desimone.fr/mcp"
    }
  }
}

🧰 Outils principaux

🌐 Instance publique

Endpoint MCP (transport Streamable HTTP) :

https://ffbb.desimone.fr/mcp

🏗️ Architecture

flowchart LR
    A[Client MCP] -->|Streamable HTTP| B[FFBB MCP Server]
    B --> C[Services métier + cache]
    C --> D[ffbb-data-client]
    D --> E[API officielle FFBB]

Points clés :

• serveur Python 3.14+ basé sur mcp[cli], starlette et uvicorn ;

• agrégation métier pour limiter le nombre d'appels et réduire le contexte LLM ;

• cache TTL adapté aux données live, calendriers et classements ;

• dashboard, métriques JSON et healthcheck intégrés.

Détails : docs/ARCHITECTURE.md et docs/PERFORMANCE.md.

💻 Développement local

uv sync --extra dev       # installer les dépendances
uv run ruff format .      # formater
uv run ruff check --fix . # linter
uv run mypy src           # vérifier les types
uv run pytest             # lancer les tests

Voir CONTRIBUTING.md pour les règles de contribution.

🧪 Tests

uv run pytest             # tests unitaires + couverture
uv run pytest tests/      # ciblé

Le pipeline CI (.github/workflows/ci.yml) exécute ruff, mypy, pytest et le contrôle de couverture à chaque push/PR.

📚 Documentation

• Exemples d’usage

• Référence des outils

• Architecture

• Performance et cache

• Déploiement Coolify

🤝 Communauté

• Contribuer

• Code de conduite

• Support

• Sécurité

❓ Dépannage