FEC-Wahlkampffinanzierungs-MCP-Server

Name: FEC Campaign Finance MCP Server
Author: reichaves

Autor: Reinaldo Chaves (reichaves@gmail.com)

GitHub Python License FastMCP OpenFEC

Ein MCP-Server, der die OpenFEC-API mit KI-Assistenten verbindet und es Ihnen ermöglicht, die US-Bundeswahlkampffinanzierung durch natürliche Konversationen zu untersuchen.

Entwickelt für Datenjournalisten, Forscher und Bürger, die komplexe Daten der Federal Election Commission (FEC) erkunden müssen, ohne die API direkt zu kennen.

Inhaltsverzeichnis

Was ist MCP?

MCP (Model Context Protocol) ist ein offener Standard, der es KI-Assistenten ermöglicht, sicher und einheitlich mit externen Systemen – Datenbanken, APIs, Dateien, Diensten – zu kommunizieren.

Die drei Arten von MCP-Fähigkeiten

Typ	Was es ist	Beispiel in diesem Projekt
Tools	Funktionen, die die KI aufrufen kann, um Daten abzurufen oder zu bearbeiten	`search_candidates()`, `get_top_donors()`
Resources	Statische oder kontextbezogene Daten, die immer verfügbar sind	FEC-Codetabellen, wichtige IDs, Glossar
Prompts	Workflow-Vorlagen zur Anleitung komplexer Untersuchungen	`investigate_candidate()`, `follow_the_money()`

Was macht dieses Projekt?

Dieses Projekt stellt die OpenFEC-API als MCP-Server bereit. Das Ergebnis: Sie können politische Finanzierung untersuchen, indem Sie einfach mit einem LLM sprechen.

Hauptfunktionen

Kandidatensuche: Finden Sie jeden Bundeskandidaten nach Name, Bundesstaat, Partei oder Amt.
Finanzanalyse: Gesamteinnahmen, Ausgaben, Schulden und Kassenbestand (Cash on Hand).
Spenderverfolgung: Identifizieren Sie die wichtigsten Geldgeber einer Kampagne und deren Arbeitgeber.
Geo-Analyse: Sehen Sie, aus welchen Bundesstaaten das Geld eines Kandidaten stammt.
Super PACs und unabhängige Ausgaben: Überwachen Sie externe Gruppen, die Geld ausgeben, um Kandidaten zu unterstützen oder anzugreifen.
Offizielle Berichte: Greifen Sie auf Unterlagen zu, die von Kampagnen und Komitees bei der FEC eingereicht wurden.
Geführte Untersuchung: Gebrauchsfertige Workflows für journalistische Recherchen.

🔍 Methodischer Hinweis (OSINT und Datenarchitektur)

Die FEC-API trennt "Kandidatensummen" (den primären Endpunkt des offiziellen Komitees) von dem Geld, das in Political Action Committees (PACs) gehalten wird. Der fec_mcp wurde strikt nach dem Prinzip der "Null-Halluzination" entwickelt. Er stellt Daten genau so dar, wie die Regierungsbürokratie sie klassifiziert. Bei OSINT-Untersuchungen liegt es am KI-Agenten oder Journalisten, search_candidates zu verwenden, um alle Principal Authorized Committees und PACs aufzulisten, die mit einem Politiker verbunden sind, und deren Finanzen einzeln abzufragen.

Mehrsprachige Unterstützung (i18n)

Der Server unterstützt Internationalisierung. Die Standardsprache für Antworten und Tipps ist Englisch. Sie können dies ändern, indem Sie die Umgebungsvariable FEC_MCP_LANG setzen (z. B. FEC_MCP_LANG=pt-br).

Verfügbare Tools

Tools

search_candidates: Suche nach Bundeskandidaten.
get_candidate_finances: Abrufen der Finanzsummen für einen Kandidaten.
search_contributions: Suche nach individuellen Spenden (Schedule A).
get_top_donors: Auflistung der Top-Spender eines Komitees.
get_contributions_by_state: Aggregation von Spenden nach Bundesstaat.
get_campaign_expenditures: Auflistung der Ausgaben einer Kampagne (Schedule B).
get_independent_expenditures: Suche nach unabhängigen Ausgaben durch Super PACs.
get_candidate_filings / get_committee_filings: Auflistung der bei der FEC eingereichten Finanzberichte.
search_pacs: Suche nach PACs und Super PACs nach Namen.
fec_help: Interne Dokumentation für die Tools.
suggest_investigation: Vorschläge für journalistische Themen basierend auf FEC-Daten.

Ressourcen

URI	Inhalt
`fec://reference/codes`	Parteicodes, Ämter, Komitee-Typen, Einreichungstypen, Spendenlimits
`fec://reference/notable_ids`	IDs von Präsidentschaftskandidaten, nationalen Komitees, relevanten Super PACs
`fec://reference/api_info`	Datenabdeckung, Ratenbegrenzungen, Nutzungstipps
`fec://reference/glossary`	Glossar der FEC-Terminologie (z. B. PAC, Schedule A, Cash on Hand)

Prompts

investigate_candidate(candidate_name): Schritt-für-Schritt-Workflow für eine vollständige Finanzuntersuchung eines Kandidaten.
follow_the_money(company_name): Verfolgt den politischen Einfluss eines Unternehmens.
compare_candidates(candidate1, candidate2): Direkter Vergleich zweier Kandidaten.

Installation

Voraussetzungen

Python 3.10+
FEC-API-Schlüssel: Kostenlos unter api.data.gov/signup

Schritte

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

Anwendungsbeispiele

Untersuchung eines Kandidaten

"Untersuche die Wahlkampffinanzen von Kamala Harris im Jahr 2024"

Das LLM führt automatisch Folgendes aus:

search_candidates(name="Kamala Harris", election_year=2024)
get_candidate_finances(candidate_id="P00009423")
get_top_donors(committee_id="C00703975")

Vergleich von Kandidaten

"Vergleiche die Finanzen von Trump und Biden für 2024"

Der Prompt compare_candidates generiert eine vollständige Tabelle mit allen Metriken im direkten Vergleich.

Bekannte Einschränkungen

Nur Bundesdaten: Staats- und Kommunalwahlen sind nicht in der FEC enthalten.
Dunkles Geld: Spenden an 501(c)(4)-Organisationen werden der FEC nicht offengelegt.
Latenz: Endpunkte für individuelle Spenden (schedule_a) können langsam sein.
Ratenbegrenzung: 1.000 Anfragen/Stunde mit dem kostenlosen API-Schlüssel.

FEC Campaign Finance MCP Server