ffbb-mcp-server 1.5.0

MCP Server for FFBB (Fédération Française de Basketball) data

🏀 FFBB MCP Server

Serveur MCP pour consulter les données officielles du basket français.

Calendriers, classements, bilans, résultats et scores live FFBB pour assistants IA compatibles MCP.

🌐 Site · 🧩 Extension VS Code · 📚 Documentation

---

Utiliser l'instance publique

Endpoint MCP public :

https://ffbb.desimone.fr/mcp

Transport : Streamable HTTP.

Endpoints utiles :

• Dashboard : https://ffbb.desimone.fr/dashboard
• Métriques : https://ffbb.desimone.fr/metrics.json
• Santé : https://ffbb.desimone.fr/health

---

Installation rapide

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

Claude Desktop

Il existe deux manières d'ajouter le serveur MCP FFBB à Claude :

Option A : Via l'interface de Claude (Recommandé)

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

1. Allez dans les Paramètres de Claude puis dans Connecteurs (ou Plugins).
2. Cliquez sur Ajouter un connecteur personnalisé.
3. Renseignez l'URL publique : https://ffbb.desimone.fr/mcp et validez.

Option B : Via claude_desktop_config.json

Pour une intégration via le fichier de configuration de Claude Desktop, vous devez utiliser le bridge SSE officiel (via npx) pour assurer la compatibilité et éviter les erreurs de validation (Claude Desktop n'acceptant que le transport stdio local).

⚠️ Prérequis : Node.js (qui inclut npm et npx) doit être installé sur votre machine. Si vous ne souhaitez pas installer Node.js, privilégiez l'Option A (sans prérequis).

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

Cursor / autres clients MCP

Configurez un serveur MCP distant :

• Type : Streamable HTTP
• URL : https://ffbb.desimone.fr/mcp

Google Antigravity

Ajoutez la configuration suivante dans votre fichier de configuration MCP :

    "ffbb": {
      "type": "http",
      "serverUrl": "https://ffbb.desimone.fr/mcp"
    }

---

Outils principaux

Outil	Usage
ffbb_bilan	Bilan complet d’une équipe, toutes phases confondues.
ffbb_team_summary	Résumé agent : bilan, classement courant, dernier résultat, prochain match.
ffbb_bilan_saison	Bilan détaillé d’une équipe précise avec numero_equipe.
ffbb_last_result	Dernier match joué.
ffbb_next_match	Prochain match.
ffbb_club	Calendrier complet, équipes ou classement d’un club.
ffbb_search	Recherche clubs, compétitions, salles, matchs, engagements.
ffbb_get	Accès technique à une ressource FFBB par identifiant.
ffbb_lives	Matchs en direct.
ffbb_saisons	Saisons disponibles.
ffbb_version	Version et diagnostic runtime.

La référence complète est dans docs/TOOLS_REFERENCE.md.

---

Architecture en bref

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
uv run ruff format .
uv run ruff check --fix .
uv run mypy src
uv run pytest

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é

---

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