FEC 선거 자금 MCP 서버

Name: FEC Campaign Finance MCP Server
Author: reichaves

작성자: Reinaldo Chaves (reichaves@gmail.com)

GitHub Python License FastMCP OpenFEC

포르투갈어로 읽기

OpenFEC API를 AI 어시스턴트와 연결하여 자연스러운 대화를 통해 미국 연방 선거 자금을 조사할 수 있게 해주는 MCP 서버입니다.

API를 직접 알지 못해도 복잡한 연방선거위원회(FEC) 데이터를 탐색해야 하는 데이터 저널리스트, 연구원 및 시민들을 위해 설계되었습니다.

MCP란 무엇인가?

**MCP(Model Context Protocol)**는 AI 어시스턴트가 데이터베이스, API, 파일, 서비스 등 외부 시스템과 안전하고 일관되게 통신할 수 있도록 하는 개방형 표준입니다.

세 가지 유형의 MCP 기능

유형	설명	이 프로젝트에서의 예시
도구(Tools)	AI가 데이터를 가져오거나 조작하기 위해 호출할 수 있는 함수	`search_candidates()`, `get_top_donors()`
리소스(Resources)	항상 사용 가능한 정적 또는 상황별 데이터	FEC 코드 테이블, 주요 ID, 용어집
프롬프트(Prompts)	복잡한 조사를 안내하는 워크플로우 템플릿	`investigate_candidate()`, `follow_the_money()`

이 프로젝트는 무엇을 하는가?

이 프로젝트는 OpenFEC API를 MCP 서버로 노출합니다. 그 결과, LLM과 대화하는 것만으로 정치 자금을 조사할 수 있습니다.

주요 기능

후보자 검색: 이름, 주, 정당 또는 직책별로 연방 후보자를 찾습니다.
재무 분석: 모금액, 지출액, 부채 및 현금 보유액 합계.
기부자 추적: 캠페인의 주요 재정 후원자와 그들의 고용주를 식별합니다.
지리적 분석: 후보자의 자금이 어느 주에서 나오는지 확인합니다.
슈퍼 PAC 및 독립적 지출: 후보자를 지원하거나 공격하기 위해 지출하는 외부 단체를 모니터링합니다.
공식 보고서: 캠페인 및 위원회가 FEC에 제출한 서류에 액세스합니다.
가이드 조사: 저널리즘 조사를 위한 즉시 사용 가능한 워크플로우.

🔍 방법론적 참고 사항 (OSINT 및 데이터 아키텍처)

FEC API는 "후보자 합계"(공식 위원회의 주요 엔드포인트)를 정치활동위원회(PAC)에 보관된 자금과 분리합니다. fec_mcp는 엄격하게 "제로 환각(Zero Hallucination)" 원칙을 위해 설계되었습니다. 정부 관료 조직이 분류하는 그대로 데이터를 노출합니다. OSINT 조사 시, 정치인에게 연결된 모든 주요 승인 위원회 및 PAC를 나열하고 재정을 개별적으로 쿼리하기 위해 search_candidates를 사용하는 것은 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 데이터를 기반으로 한 저널리즘 기사 제안.

리소스

URI	콘텐츠
`fec://reference/codes`	정당 코드, 직책, 위원회 유형, 제출 유형, 기부 한도
`fec://reference/notable_ids`	대통령 후보, 전국 위원회, 관련 슈퍼 PAC의 ID
`fec://reference/api_info`	데이터 범위, 속도 제한, 사용 팁
`fec://reference/glossary`	FEC 용어집 (예: PAC, 스케줄 A, 현금 보유액)

프롬프트

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

사용 예시

후보자 조사

"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에 포함되지 않습니다.
어둠의 자금(Dark money): 501(c)(4)에 대한 기부는 FEC에 공개되지 않습니다.
지연 시간: 개별 기부 엔드포인트(schedule_a)는 느릴 수 있습니다.
속도 제한: 무료 API 키로 시간당 1,000회 요청 가능.

FEC Campaign Finance MCP Server