André — Analyse électorale française

André MCP — 法国选举分析

MCP（Model Context Protocol）服务，可访问 55 场法国选举的投票站级结果 （1999-2026），并与 INSEE 的社会人口数据、共和国民选官员数据库及 官方行政区划数据进行交叉分析。

托管服务，开箱即用： https://mcp.andre.vote/mcp 无需安装、下载数据或身份验证。

此代码库包含 MCP 服务的代码，采用 MIT 许可证发布。它是 André 单体代码库中 andre-mcp/ 的自动镜像；单体代码库仍是唯一可信来源： 请在此处提交 issue，而不是直接提交 commit（直接提交的内容会在下次镜像时被覆盖）。

连接

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 对每轮对话的工具调用次数设定了约 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 提供可在一次调用中完成查询的 “panel” 操作，以降低达到工具调用上限的风险：

• compare_elections — 比较某个地区的两场选举
• 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 — 主要 skill（工作流、调试）

预构建提示词

• analyser_commune — 对一个市镇进行全面的选举分析
• reserves_de_voix — 识别某政治力量的潜在选票
• carte_electorale — 某省的专题地图
• comparer_elections — 比较两场选举的时间变化
• 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	三层级政治编码

社会人口统计数据通过法国国家投票站观察站的权重，从 IRIS 插值到投票站。

限制与稳健性

该服务以只读方式公开数据，无需身份验证。已设置以下防护措施：

• query_sql — DuckDB 只读连接，禁止写入查询；对没有显式限制的 SELECT/WITH 注入安全 LIMIT。
• 并发保护 — 限制同时执行的重型任务数量；超过限制时会友好地返回“服务器繁忙”。
• 指标 — 在 /metrics 上提供 Prometheus 序列（工具、延迟、错误率、并发数）。不会暴露参数、结果或会话标识符。

本地运行

即使没有任何数据，服务也能启动并响应自省请求（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

但是，工具调用目前无法在 monorepo 之外运行：服务会将查询委托给尚未打包的脚本（query_elections.py、query_admin.py、generate_map.py 等），并且需要预置完整数据集（约 1.5 GB）。独立的 PyPI 软件包正在筹备中。

如需实际使用，请连接到远程服务。

注册

已以 vote.andre/elections 的名称发布到 MCP 官方注册表（命名空间通过 DNS 在 andre.vote 上验证）。请参阅 server.json。

许可证

MIT — 请参阅 LICENSE。

数据仍受其各自提供方的许可证约束（Licence Ouverte 2.0、CC BY 4.0）。