🏀 FFBB MCP Server

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

Related MCP server: SportScore

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

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

Outils principaux

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é