Elections Canada MCP Server

Elections Canada MCP 服务

这是一个模型上下文协议（MCP）服务，可访问加拿大联邦选举数据。目前支持 2021 年和 2025 年选举的结果。未来更新将包含往届选举、人口普查人口统计数据以及 ThreeFortyThree 实时预测。

本服务由 ThreeFortyThree 提供，可为 ThreeFortyThree Chat 提供支持，也可与 Claude Desktop 等 MCP 客户端搭配使用。

---

🛠 设置

安装（通过 PyPI）

uv pip install elections-canada-mcp-server

---

在 Claude Desktop 中使用

1. 确保已安装服务：

uv pip install elections-canada-mcp-server

2. 打开 claude_desktop_config.json 并添加以下代码块：

uv

{
  "mcpServers": {
    "elections_canada_data_and_predictions": {
      "command": "{PATH_TO_UVX}",  // Replace with output of: which uvx
      "args": ["elections-canada-mcp"]
    }
  }
}

3. 重启 Claude Desktop。

4. 现在可以向 Claude 提出以下问题：

   • “多伦多中心选区 2021 年的选举结果是什么？”
   • “哪些选区的 NDP 竞争最激烈？”
   • “列出保守党在 2021 年以最高得票差获胜的选区。”

---

本地开发

使用 MCP Inspector 测试服务：

1. 克隆此代码库：

   git clone https://github.com/ThreeFortyThree-Canada/elections-canada-mcp-server.git
   cd elections-canada-mcp-server
   

2. 安装 MCP CLI：

   uv pip install mcp
   

3. 测试服务：

   mcp dev elections_canada_mcp/server.py
   

这会打开一个网页 UI，以便在本地测试服务。

---

🧰 工具

工具	描述	输入	返回值
search_ridings	按名称搜索选区（不区分重音符号）	search_term: str	匹配的选区列表
get_party_votes	获取某个选区的得票份额（可选按政党筛选）	riding_code: str, party_code: str (optional)	得票数和百分比
get_winning_party	获取某个选区的获胜政党	riding_code: str	获胜政党
summarize_province_results	省级得票数／席位数摘要	province_name_or_code: str	政党结果
summarize_national_results	加拿大全国选举摘要	—	全国政党结果
find_closest_ridings	查找竞争最激烈的选区	num_results: int, party: str (optional)	得票差最小的选区
best_and_worst_results	某个政党的最佳／最差选区	party: str, num_entries: int	四类表现摘要

---

📚 资源

资源	URI
所有选区	elections-canada://ridings
单个选区	elections-canada://riding/{riding_code}
省份	elections-canada://province/{province_code}

---

📌 省份代码

AB、BC、MB、NB、NL、NS、NT、NU、ON、PE、QC、SK、YT

📌 政党代码

LPC、CPC、NDP、BQ、GPC、PPC

---

📄 许可证

本项目采用 MIT 许可证。

© ThreeFortyThree Canada – threefortythree.ca