🏀 FFBB MCP Server

Logo FFBB MCP

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

Version Python Version Badge Smithery Statut CI Licence

⚡ Démarrage express

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

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…).

📑 Sommaire

✨ 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

Option A — Via l'interface de Claude (recommandé, sans prérequis)

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.
Option B — Via claude_desktop_config.json (nécessite Node.js)

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

[!WARNING] Prérequis : Node.js (inclut npm et npx). Sans Node.js, privilégiez l'Option A.

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

Cursor / autres clients MCP

Configurez un serveur MCP distant :

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

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

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.

[!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
Endpoint URL
📊 Dashboard https://ffbb.desimone.fr/dashboard
📈 Métriques https://ffbb.desimone.fr/metrics.json
❤️ Santé https://ffbb.desimone.fr/health

🏗️ 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

🤝 Communauté

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

Project links

Data verified by PyPI on Jul 9, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (1.7.0)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for Nick63 from gravatar.com Nick63

GitHub Statistics

Data verified by PyPI on Jul 9, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

Apache-2.0

Requires

Python >=3.14

Provides Extra

dev docs

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ffbb_mcp_server-1.6.0.tar.gz (136.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

ffbb_mcp_server-1.6.0-py3-none-any.whl (106.1 kB view details)

Uploaded Python 3

File details

Details for the file ffbb_mcp_server-1.6.0.tar.gz.

File metadata

  • Download URL: ffbb_mcp_server-1.6.0.tar.gz
  • Upload date:
  • Size: 136.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.11.28 {"installer":{"name":"uv","version":"0.11.28","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for ffbb_mcp_server-1.6.0.tar.gz
Algorithm Hash digest
SHA256 ae080884bcd9b036b08a84558e4caa4f97cc09b7106c1e629a9ef4cf2aaa9db7
MD5 aba2e80c1cc6bf0855c2e60bde90a79e
BLAKE2b-256 8909228b3a3c2b9069b1797881f05f46ddaba222d3de361e17e60e8ab17ee419

See more details on using hashes here.

File details

Details for the file ffbb_mcp_server-1.6.0-py3-none-any.whl.

File metadata

  • Download URL: ffbb_mcp_server-1.6.0-py3-none-any.whl
  • Upload date:
  • Size: 106.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.11.28 {"installer":{"name":"uv","version":"0.11.28","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for ffbb_mcp_server-1.6.0-py3-none-any.whl
Algorithm Hash digest
SHA256 537850bd40760ae1c3502d69cd83c262f124854885b40eac651cc84eddc45ff9
MD5 517cace203de5f63e4520888ae78c390
BLAKE2b-256 b1c91b8549a8f5f67dfa4d0cd1c7d705a9ec67de5a505626ac29aaee1f66e210

See more details on using hashes here.

Release history Release notifications | RSS feed

1.7.0

2 files

1.6.1

2 files

This release

1.6.0 This release

2 files

1.5.1

2 files

1.5.0

2 files

1.4.0

2 files

1.3.2

2 files

1.3.1

2 files

1.3.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page