FEC Campaign Finance MCP Server
MCP-сервер финансирования избирательных кампаний FEC
Автор: Рейналдо Чавес (reichaves@gmail.com)
Читайте это на португальском
MCP-сервер, который подключает API OpenFEC к ИИ-ассистентам, позволяя вам исследовать финансирование федеральных избирательных кампаний в США с помощью естественного общения.
Разработано для дата-журналистов, исследователей и граждан, которым необходимо изучать сложные данные Федеральной избирательной комиссии (FEC), не вникая напрямую в работу API.
Содержание
Related MCP server: fec-mcp-server
Что такое MCP?
MCP (Model Context Protocol) — это открытый стандарт, который позволяет ИИ-ассистентам безопасно и единообразно взаимодействовать с внешними системами: базами данных, API, файлами и сервисами.
Три типа возможностей MCP
Тип | Что это | Пример в этом проекте |
Инструменты | Функции, которые ИИ может вызывать для получения или обработки данных |
|
Ресурсы | Статические или контекстные данные, которые всегда доступны | Таблицы кодов FEC, важные ID, глоссарий |
Промпты | Шаблоны рабочих процессов для сложных расследований |
|
Что делает этот проект?
Этот проект предоставляет доступ к API OpenFEC в качестве MCP-сервера. Результат: вы можете расследовать политическое финансирование, просто общаясь с LLM.
Ключевые возможности
Поиск кандидатов: Поиск любого федерального кандидата по имени, штату, партии или должности.
Финансовый анализ: Общие суммы собранных и потраченных средств, долги и остатки на счетах.
Отслеживание доноров: Определение крупнейших спонсоров кампании и их работодателей.
Геоанализ: Просмотр того, из каких штатов поступают средства кандидата.
Суперкомитеты (Super PACs) и независимые расходы: Мониторинг сторонних групп, тратящих средства на поддержку или критику кандидатов.
Официальные отчеты: Доступ к финансовой отчетности, поданной в FEC кампаниями и комитетами.
Направляемое расследование: Готовые рабочие процессы для журналистских расследований.
🔍 Методологическое примечание (OSINT и архитектура данных)
API FEC разделяет «Итоговые показатели кандидата» (основная конечная точка официального комитета) и средства, находящиеся в распоряжении комитетов политических действий (PAC). fec_mcp был разработан строго в соответствии с принципом «нулевых галлюцинаций». Он предоставляет данные именно в том виде, в котором их классифицирует государственная бюрократия.
В расследованиях OSINT задача ИИ-агента или журналиста — использовать search_candidates, чтобы перечислить все основные уполномоченные комитеты и PAC, привязанные к политику, и запрашивать их финансы по отдельности.
Поддержка нескольких языков (i18n)
Сервер поддерживает интернационализацию. Языком ответов и подсказок по умолчанию является английский. Вы можете изменить это, установив переменную окружения FEC_MCP_LANG (например, FEC_MCP_LANG=ru-ru).
Доступные инструменты
Инструменты
search_candidates: Поиск федеральных кандидатов.get_candidate_finances: Получение финансовых итогов для кандидата.search_contributions: Поиск индивидуальных пожертвований (Schedule A).get_top_donors: Список крупнейших доноров комитета.get_contributions_by_state: Агрегирование пожертвований по штатам.get_campaign_expenditures: Список расходов кампании (Schedule B).get_independent_expenditures: Поиск независимых расходов суперкомитетов (Super PACs).get_candidate_filings/get_committee_filings: Список финансовых отчетов, поданных в FEC.search_pacs: Поиск PAC и Super PAC по названию.fec_help: Внутренняя документация по инструментам.suggest_investigation: Предложения для журналистских расследований на основе данных FEC.
Ресурсы
URI | Содержимое |
| Коды партий, должностей, типов комитетов, типов отчетов, лимиты пожертвований |
| ID кандидатов в президенты, национальных комитетов, значимых Super PAC |
| Охват данных, лимиты запросов, советы по использованию |
| Глоссарий терминологии FEC (например, PAC, Schedule A, Cash on Hand) |
Промпты
investigate_candidate(candidate_name): Пошаговый рабочий процесс для полного финансового расследования кандидата.follow_the_money(company_name): Отслеживание политического влияния компании.compare_candidates(candidate1, candidate2): Сравнение двух кандидатов бок о бок.
Установка
Предварительные требования
Python 3.10+
Ключ API FEC: Бесплатно на 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 автоматически выполнит:
search_candidates(name="Kamala Harris", election_year=2024)get_candidate_finances(candidate_id="P00009423")get_top_donors(committee_id="C00703975")
Сравнение кандидатов
«Сравни финансы Трампа и Байдена за 2024 год»
Промпт compare_candidates создает полную таблицу со всеми показателями для сравнения.
Известные ограничения
Только федеральные данные: Выборы в штатах и местные выборы не входят в FEC.
«Темные деньги»: Пожертвования в организации 501(c)(4) не раскрываются в FEC.
Задержка: Конечные точки для индивидуальных пожертвований (
schedule_a) могут работать медленно.Лимит запросов: 1000 запросов в час с бесплатным ключом API.
Внешние ресурсы
This server cannot be deployed
Maintenance
Related MCP Connectors
Access FEC campaign finance data. Query data about candidates, money trails, and election filings.
FEC campaign finance data: candidate fundraising, donors, and spending
U.S. civic data for AI agents: reps, votes, bills, finance, lobbying, cited gov sources. 47 tools.
OpenFEC MCP — Federal Election Commission campaign finance data
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables interaction with Federal Election Commission data via the OpenFEC API, providing access to campaign finance information such as candidates, committees, contributions, and expenditures through the Model Context Protocol.122BSD 3-Clause
- AlicenseAqualityBmaintenanceQuery FEC campaign finance data — search candidates, track donations, analyze spending, and monitor Super PAC activity via the OpenFEC API.89 npm4MIT
- AlicenseBqualityDmaintenanceMCP server giving AI agents access to US political finance data: campaign contributions, PAC spending, lobbying records, and voting behavior.61MIT
- AlicenseNot gradedqualityDmaintenanceEnables searching political donations, donors, and lobbying data from any AI assistant using Federal Election Commission data.7 npmMIT