FEC 竞选财务 MCP 服务器

作者：Reinaldo Chaves (reichaves@gmail.com)

阅读 葡萄牙语版本

一个将 OpenFEC API 连接到 AI 助手的 MCP 服务器，让您可以通过自然对话调查美国联邦竞选财务状况。

专为数据记者、研究人员和公民设计，他们需要探索复杂的联邦选举委员会 (FEC) 数据，而无需直接了解 API。

目录

• 什么是 MCP？

• 该项目的功能是什么？

• 架构

• 可用工具

• 安装

• 配置

• 使用示例

• 开发与测试

什么是 MCP？

MCP (模型上下文协议) 是一项开放标准，使 AI 助手能够安全且统一地与外部系统（数据库、API、文件、服务）进行通信。

三种 MCP 功能类型

该项目的功能是什么？

该项目将 OpenFEC API 暴露为 MCP 服务器。结果：您只需与 LLM 对话即可调查政治融资。

核心功能

• 候选人搜索：按姓名、州、党派或职位查找任何联邦候选人。

• 财务分析：筹款总额、支出、债务和手头现金。

• 捐赠者追踪：识别竞选活动的主要资助者及其雇主。

• 地理分析：查看候选人的资金来源州。

• 超级政治行动委员会 (Super PACs) 和独立支出：监控支持或攻击候选人的外部团体支出。

• 官方报告：访问竞选活动和委员会提交给 FEC 的文件。

• 引导式调查：为新闻调查准备的现成工作流。

🔍 方法论说明 (OSINT 与数据架构)

FEC API 将“候选人总额”（官方委员会的主要端点）与政治行动委员会 (PACs) 持有的资金分离开来。fec_mcp 的设计严格遵循 “零幻觉” 原则。它完全按照政府官僚机构的分类方式展示数据。 在 OSINT 调查中，由 AI 代理或记者负责使用 search_candidates 列出与政治人物相关的所有 主要授权委员会和 PACs，并分别查询其财务状况。

多语言支持 (i18n)

服务器支持国际化。响应和提示的默认语言为英语。您可以通过设置 FEC_MCP_LANG 环境变量来更改此设置（例如 FEC_MCP_LANG=pt-br）。

可用工具

工具

• search_candidates：搜索联邦候选人。

• get_candidate_finances：获取候选人的财务总额。

• search_contributions：搜索个人捐款 (Schedule A)。

• get_top_donors：列出委员会的主要捐赠者。

• get_contributions_by_state：按州汇总捐款。

• get_campaign_expenditures：列出竞选支出 (Schedule B)。

• get_independent_expenditures：搜索超级政治行动委员会的独立支出。

• get_candidate_filings / get_committee_filings：列出提交给 FEC 的财务报告。

• search_pacs：按名称搜索 PACs 和超级政治行动委员会。

• fec_help：工具的内部文档。

• suggest_investigation：基于 FEC 数据的新闻选题建议。

资源

提示词

• investigate_candidate(candidate_name)：对候选人进行完整财务调查的分步工作流。

• follow_the_money(company_name)：追踪公司的政治影响力。

• compare_candidates(candidate1, candidate2)：两位候选人的并排比较。

安装

先决条件

• Python 3.10+

• FEC API 密钥：在 api.data.gov/signup 免费获取

步骤

git clone https://github.com/your-username/fec-mcp-server.git
cd fec-mcp-server
python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate
pip install -r requirements.txt
echo "FEC_API_KEY=your_key_here" > .env

使用示例

调查候选人

“调查 Kamala Harris 2024 年的竞选财务状况”

LLM 将自动执行：

1. search_candidates(name="Kamala Harris", election_year=2024)

2. get_candidate_finances(candidate_id="P00009423")

3. get_top_donors(committee_id="C00703975")

比较候选人

“比较 Trump 和 Biden 2024 年的财务状况”

compare_candidates 提示词会生成一个包含所有指标并排对比的完整表格。

已知限制

• 仅限联邦数据：州和地方选举数据不在 FEC 中。

• 黑钱：向 501(c)(4) 组织的捐款不会向 FEC 披露。

• 延迟：个人捐款端点 (schedule_a) 可能较慢。

• 速率限制：使用免费 API 密钥每小时 1,000 次请求。

外部资源

• OpenFEC API — 文档

• FEC — 官方网站

• OpenSecrets

• FastMCP — 文档

• MCP — 协议规范