joelgombin/andre-mcp

Serveur MCP (Model Context Protocol) donnant accès aux résultats de **55 élections
françaises (1999-2026) au niveau du bureau de vote**, croisés avec les données
socio-démographiques de l'INSEE, la base des élus de la République et les
découpages administratifs officiels.
**Serveur hébergé, prêt à l'emploi :** https://mcp.andre.vote/mcp
Aucune installation, aucun téléchargement de données, aucune authentification.
> Ce dépôt contient le code du serveur MCP, publié sous licence MIT. Il est un
> **miroir automatique** de andre-mcp/ dans le monorepo André, qui reste la
> source de vérité : les contributions passent par des issues ici, pas par des
> commits directs (ils seraient écrasés au prochain miroitage).
Connexion
Claude Code
Claude Desktop, Cursor, VS Code…
Emplacement du fichier pour Claude Desktop :
- macOS : ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows : %APPDATA%\Claude\claude_desktop_config.json
Pour les clients qui ne gèrent pas encore le transport HTTP :
> **Limite d'appels d'outils sur Claude.ai / Claude Desktop**
>
> Claude impose une limite d'environ 15-20 appels d'outils par tour de
> conversation. Les analyses approfondies (résultats T1+T2, bureaux de vote,
> croisement socio-démographique…) peuvent l'atteindre. Cliquez **Continuer**
> pour reprendre. Pour des analyses complètes sans interruption,
> andre.vote n'a pas cette contrainte.
Outils
| Outil | Description |
|-------|-------------|
| query_elections | Résultats électoraux (55 élections, 1999-2026) |
| query_admin | Divisions administratives (communes, EPCI, cantons, départements) |
| query_elus | Élus de la République (base BRÉF, Zenodo) |
| query_sociodem | Données socio-démographiques INSEE au niveau bureau de vote |
| query_sql | Requêtes SQL directes sur la base DuckDB (lecture seule) |
| query_dlp | Composition sociale des candidats municipaux 2020 |
| generate_map | Cartes électorales multi-couches |
| visualize | Visualisations Plotly (bar, line, scatter…) |
| simulate_fusions | Simulation de fusions de listes municipales |
| export_data | Export CSV/JSON/TSV |
| create_data_table | Tableaux de données formatés |
Tous les outils portent un title et une annotation readOnlyHint /
destructiveHint. **Aucun outil n'est destructif** : le serveur est en lecture
seule sur des données publiques.
query_elections propose des **actions « panel »** qui répondent en un seul
appel, ce qui limite le risque d'atteindre le plafond d'appels d'outils :
- compare_elections — compare deux scrutins pour un territoire
- query_all_circonscriptions — vainqueur de chaque circonscription (législatives)
- vote_reserve — score d'une famille + abstention par bureau (réserves de voix)
- select_communes — sélectionne/classe des communes par critères géographiques, démographiques et électoraux
- cross_election_panel — évolution d'une famille ou d'une nuance par commune sur N scrutins
- bureau_breakdown — pivot par bureau (top nuances + participation, socio-démo en option)
Resources documentaires
Références consultables automatiquement par le client :
- andre://references/methodologies — méthodologies d'analyse (réserves, typologies, ACP)
- andre://references/data_schema — schéma des données électorales