André — Analyse électorale française

André MCP — フランスの選挙分析

フランスの55回の選挙（1999～2026年）の投票所レベルの結果にアクセスできるMCP（Model Context Protocol）サーバーです。INSEEの社会人口統計データ、共和国の公職者データベース、公式の行政区画と照合できます。

ホスト済みですぐに使えるサーバー： https://mcp.andre.vote/mcp インストール不要、データのダウンロード不要、認証不要です。

このリポジトリには、MITライセンスで公開されているMCPサーバーのコードが含まれています。これは、モノレポ André 内の andre-mcp/ の自動ミラーです。モノレポが引き続き信頼できる唯一の情報源となるため、貢献はここでのイシューを通じて行ってください。直接コミットしても、次回のミラーリング時に上書きされます。

接続

Claude Code

claude mcp add --transport http andre https://mcp.andre.vote/mcp

Claude Desktop、Cursor、VS Code など

{
  "mcpServers": {
    "andre": {
      "type": "http",
      "url": "https://mcp.andre.vote/mcp"
    }
  }
}

Claude Desktop の設定ファイルの場所：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

HTTP トランスポートにまだ対応していないクライアントの場合：

{
  "mcpServers": {
    "andre": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.andre.vote/mcp"]
    }
  }
}

Claude.ai／Claude Desktop でのツール呼び出し回数の制限

Claude では、会話の1ターンあたりのツール呼び出し回数が約15～20回に制限されています。詳細な分析（T1＋T2の結果、投票所、社会人口統計とのクロス分析など）では、この上限に達することがあります。続行をクリックして再開してください。中断なしで完全な分析を行うには、andre.voteをご利用ください。この制限はありません。

ツール

ツール	説明
query_elections	選挙結果（55回の選挙、1999～2026年）
query_admin	行政区画（コミューン、EPCI、カントン、県）
query_elus	共和国の公職者（BRÉFデータベース、Zenodo）
query_sociodem	投票所レベルのINSEE社会人口統計データ
query_sql	DuckDBデータベースへの直接SQLクエリ（読み取り専用）
query_dlp	2020年の市議会選挙候補者の社会的構成
generate_map	複数レイヤーの選挙地図
visualize	Plotlyによる可視化（棒、折れ線、散布図など）
simulate_fusions	市議会選挙の名簿統合シミュレーション
export_data	CSV／JSON／TSV形式でエクスポート
create_data_table	書式設定されたデータテーブル

すべてのツールには title と readOnlyHint ／ destructiveHint アノテーションがあります。破壊的なツールはありません。サーバーは公開データに対して読み取り専用で動作します。

query_elections には、1回の呼び出しで結果を返す**「パネル」アクション**があり、ツール呼び出し回数の上限に達するリスクを抑えられます。

• compare_elections — ある地域の2つの選挙を比較します
• query_all_circonscriptions — 各選挙区の当選者（国民議会選挙）
• vote_reserve — 投票所ごとの政治勢力の得票率と棄権率（潜在票）
• select_communes — 地理、人口統計、選挙の基準でコミューンを選択／順位付けします
• cross_election_panel — N回の選挙にわたるコミューンごとの政治勢力または政治的傾向の推移
• bureau_breakdown — 投票所ごとの集計（上位の政治的傾向と投票率。オプションで社会人口統計も表示）

ドキュメントリソース

クライアントが自動的に参照できる資料：

• andre://references/methodologies — 分析手法（潜在票、類型、ACP）
• andre://references/data_schema — 選挙データのスキーマ
• andre://references/political_colors — 政治勢力の色
• andre://references/election_dates — 55回の選挙の日付
• andre://references/victory_rules — 選挙種別ごとの勝利ルール
• andre://references/nuances — 政治的傾向コード
• andre://references/insee_variables — INSEEの社会人口統計変数
• andre://skills/electoral-analysis — 主要スキル（ワークフロー、デバッグ）

事前構築済みプロンプト

• analyser_commune — 市町村の包括的な選挙分析
• reserves_de_voix — 政治勢力の票の上積み余地の特定
• carte_electorale — 県の主題図
• comparer_elections — 2つの選挙の時系列比較
• resultats_rapides — 選挙結果の概要

例

Analyse les résultats des législatives 2024 à Marseille
→ query_admin (code 13055) puis query_elections puis query_sociodem

Quelles sont les communes les plus abstentionnistes des Bouches-du-Rhône
aux européennes 2024 ?
→ query_sql avec une requête agrégée

データ

公式の公開ソースのみを使用しています。

ソース	ライセンス	内容
data.gouv.fr	Licence Ouverte 2.0	選挙結果、候補者情報
IGN / Etalab	Licence Ouverte 2.0	行政区域の境界
INSEE	Licence Ouverte 2.0	社会人口統計データ
BRÉF (Zenodo)	CC BY 4.0	共和国の公選職者
FERD	CC BY 4.0	3段階の政治的コーディング

社会人口統計データは、Observatoire national des bureaux de vote の重み付けを用いて、IRIS から投票所単位に補間されています。

制限と堅牢性

サーバーは、認証なしで読み取り専用の公開データを提供します。 以下のガードレールを設けています。

• query_sql — 読み取り専用の DuckDB 接続。書き込みクエリは ブロックされ、明示的な上限のない SELECT／WITH には安全用の LIMIT が挿入されます。
• 同時実行の制限 — 負荷の高い実行の同時数を制限し、上限を 超えると「サーバーがビジーです」と適切に応答します。
• メトリクス — /metrics で Prometheus の時系列データを提供します （ツール、レイテンシ、エラー率、同時実行数）。引数、結果、 セッション ID は公開されません。

ローカルでの実行

サーバーはデータがなくても起動し、イントロスペクションに応答します （tools/list、resources/list、prompts/list）。

pip install .
python -c "from andre_mcp.server import run; run()"

または Docker 経由：

docker build -t andre-mcp .
docker run -i --rm andre-mcp

一方、モノレポ外では、ツール呼び出しはまだ機能しません。サーバーは クエリをスクリプト（query_elections.py、query_admin.py、 generate_map.py など）に委譲しますが、これらはまだパッケージに 含まれていません。また、完全なデータセット（約1.5 GB）の準備も必要です。 スタンドアロンの PyPI パッケージを準備中です。

実際に利用するには、リモートサーバーに接続してください。

レジストリ

公式 MCP レジストリに vote.andre/elections という名前で公開されています （名前空間は andre.vote の DNS 検証済み）。server.json をご覧ください。

ライセンス

MIT — LICENSE をご覧ください。

データには、それぞれの提供元のライセンス （Licence Ouverte 2.0、CC BY 4.0）が適用されます。