🏀 FFBB MCP Server

⚡ Démarrage express

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 votre client (VS Code, Claude, Cursor…).

Related MCP server: SportScore

📑 Sommaire

• ✨ Fonctionnalités

• 🚀 Installation

  • VS Code / GitHub Copilot

  • Claude Desktop

  • Cursor / autres clients MCP

  • Google Antigravity

• 🧰 Outils principaux

• 🌐 Instance publique

• 🏗️ Architecture

• 💻 Développement local

• 📚 Documentation

• 🤝 Communauté

✨ 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

Les versions récentes de Claude permettent d'ajouter des connecteurs directement depuis l'interface graphique :

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

"ffbb": {
  "command": "npx",
  "args": [
    "-y",
    "mcp-remote",
    "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.

📚 Documentation

• Exemples d’usage

• Référence des outils

• Architecture

• Performance et cache

• Déploiement Coolify

🤝 Communauté

• Contribuer

• Code de conduite

• Support

• Sécurité