⚡ Démarrage express (< 2 min)

[!TIP] Aucune installation requise : le serveur est hébergé publiquement. Ajoutez simplement l'endpoint MCP à votre client :

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.

✨ 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

{
  "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

[!WARNING] Un bug connu du client Go d'Antigravity (timeouts d'initialisation trop courts, gestion SSE sur serveur distant) peut provoquer des erreurs context deadline exceeded en type: "http". Utilisez plutôt le proxy local mcp-remote (installé à la volée via npx) :

"ffbb": {
  "command": "npx",
  "args": ["-y", "mcp-remote", "https://ffbb.desimone.fr/mcp"]
}

🧰 Outils principaux

[!NOTE] Référence complète des paramètres : docs/TOOLS_REFERENCE.md.

🌐 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

📌 Recommandations GitHub

Description suggérée :

🏀 MCP server exposing official French basketball (FFBB) data — schedules, standings, live scores & more — for AI assistants.

Topics suggérés (≤ 20) :

mcp · model-context-protocol · python · ffbb · basketball · open-data · ai · llm · claude · vscode · vscode-extension · mcp-server · sports · dns · api · starlette · uvicorn · docker · assistant · france

Projet non officiel, non affilié à la Fédération Française de BasketBall.