FEC選挙資金MCPサーバー

著者: Reinaldo Chaves (reichaves@gmail.com)

ポルトガル語版はこちら

OpenFEC APIをAIアシスタントに接続し、自然な会話を通じて米国の連邦選挙資金を調査できるMCPサーバーです。

データジャーナリスト、研究者、そしてAPIを直接知らなくても複雑な連邦選挙委員会（FEC）のデータを調査する必要がある市民向けに設計されています。

目次

• MCPとは？

• このプロジェクトでできること

• アーキテクチャ

• 利用可能なツール

• インストール

• 設定

• 使用例

• 開発とテスト

MCPとは？

MCP (Model Context Protocol) は、AIアシスタントがデータベース、API、ファイル、サービスなどの外部システムと安全かつ統一された方法で通信できるようにするオープン標準です。

3種類のMCP機能

このプロジェクトでできること

このプロジェクトは、OpenFEC APIをMCPサーバーとして公開します。その結果、LLMと会話するだけで政治資金を調査できるようになります。

主な機能

• 候補者検索: 名前、州、政党、または役職で連邦候補者を検索します。

• 財務分析: 資金調達総額、支出、負債、手元資金（Cash on Hand）。

• 寄付者追跡: 選挙運動の主要な資金提供者とその雇用主を特定します。

• 地理的分析: 候補者の資金がどの州から来ているかを確認します。

• スーパーPACおよび独立支出: 候補者を支援または攻撃するために支出している外部団体を監視します。

• 公式報告書: 選挙運動や委員会がFECに提出した報告書にアクセスします。

• ガイド付き調査: ジャーナリズム調査のためのすぐに使えるワークフロー。

🔍 方法論に関する注記 (OSINTおよびデータアーキテクチャ)

FEC APIは、「候補者合計」（公式委員会の主要エンドポイント）と政治活動委員会（PAC）に保管されている資金を分離しています。fec_mcpは厳密に**「ゼロ・ハルシネーション（幻覚ゼロ）」の原則に基づいて設計されています。政府の官僚機構が分類する通りにデータを公開します。 OSINT調査においては、search_candidatesを使用して政治家に付随するすべての主要認定委員会およびPAC**をリストアップし、それぞれの財務状況を個別に照会することは、AIエージェントまたはジャーナリストの役割となります。

多言語サポート (i18n)

サーバーは国際化をサポートしています。応答とヒントのデフォルト言語は英語です。FEC_MCP_LANG環境変数を設定することで変更可能です（例: FEC_MCP_LANG=pt-br）。

利用可能なツール

ツール

• search_candidates: 連邦候補者を検索します。

• get_candidate_finances: 候補者の財務合計を取得します。

• search_contributions: 個人の寄付（スケジュールA）を検索します。

• get_top_donors: 委員会の主要寄付者をリストアップします。

• get_contributions_by_state: 州ごとの寄付を集計します。

• get_campaign_expenditures: 選挙運動の支出（スケジュールB）をリストアップします。

• get_independent_expenditures: スーパーPACによる独立支出を検索します。

• get_candidate_filings / get_committee_filings: FECに提出された財務報告書をリストアップします。

• search_pacs: 名前でPACおよびスーパーPACを検索します。

• fec_help: ツールに関する内部ドキュメント。

• suggest_investigation: FECデータに基づくジャーナリズムの調査提案。

リソース

プロンプト

• investigate_candidate(candidate_name): 候補者の完全な財務調査のためのステップバイステップのワークフロー。

• follow_the_money(company_name): 企業の政治的影響力を追跡します。

• compare_candidates(candidate1, candidate2): 2人の候補者の比較。

インストール

前提条件

• 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

使用例

候補者の調査

"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")

候補者の比較

"2024年のトランプとバイデンの財務状況を比較して"

compare_candidatesプロンプトは、すべての指標を並べた完全なテーブルを生成します。

既知の制限

• 連邦データのみ: 州および地方選挙はFECに含まれていません。

• ダークマネー: 501(c)(4)への寄付はFECに開示されません。

• レイテンシ: 個別の寄付エンドポイント（schedule_a）は遅い場合があります。

• レート制限: 無料のAPIキーで1時間あたり1,000リクエスト。

外部リソース

• OpenFEC API — ドキュメント

• FEC — 公式ウェブサイト

• OpenSecrets

• FastMCP — ドキュメント

• MCP — プロトコル仕様