MCP OpenFEC 서버

OpenFEC API를 통해 연방선거위원회(FEC) 선거자금 데이터에 대한 액세스를 제공하는 모델 컨텍스트 프로토콜(MCP) 서버입니다.

특징

이름, 주 또는 직책별로 후보자 검색
후보자에 대한 자세한 정보와 재무 데이터를 얻으세요
접근위원회 정보
개별 기여 보기
독립적인 지출을 추적하세요
FEC 제출 및 감사 사례에 접근하세요
대량 데이터 다운로드

Related MCP server: FRED MCP Server

요구 사항

Node.js(v16 이상)
OpenFEC API 키( 여기서 받으세요 )

설치

저장소를 복제합니다.

지엑스피1

종속성 설치:

npm install

루트 디렉토리에 .env 파일을 만들고 OpenFEC API 키를 추가하세요.

OPENFEC_API_KEY=your_api_key_here

서버를 빌드하세요:

npm run build

구성

Claude Desktop과 함께 이 MCP 서버를 사용하려면:

Claude Desktop 구성 파일을 찾으세요.
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
- 리눅스: ~/.config/Claude/claude_desktop_config.json
다음 구성을 파일에 추가합니다.

{ "mcpServers": { "openfec": { "command": "node", "args": ["/absolute/path/to/mcp-openfec/build/server.js"], "env": { "OPENFEC_API_KEY": "your_api_key_here" }, "disabled": false, "autoApprove": [] } } }

중요 구성 참고 사항:

/absolute/path/to/mcp-openfec 저장소를 복제한 실제 경로로 바꾸십시오.
상대 경로가 아닌 절대 경로를 사용하세요
서버를 활성화하려면 disabled``false 로 설정합니다.
보안을 위해 autoApprove 빈 배열로 유지하세요.
env 섹션에 OpenFEC API 키를 추가하세요.

사용 가능한 도구

get_candidate : 후보자에 대한 자세한 정보를 가져옵니다.
get_candidate_financials : 후보자의 재정 데이터를 가져옵니다.
search_candidates : 이름이나 다른 기준으로 후보자를 검색합니다.
get_committee : 위원회에 대한 자세한 정보를 가져옵니다.
get_candidate_contributions : 후보자의 개별 기여금을 받습니다.
get_filings : 공식 FEC 서류 검색
get_independent_expenditures : 독립 지출 가져오기
get_electioneering : 선거 운동 관련 소식 받기
get_party_coordinated_expenditures : 파티 조정 지출을 가져옵니다.
get_communication_costs : 기업/노조 커뮤니케이션 비용 가져오기
get_audit_cases : FEC 감사 사례 및 결과 가져오기
get_bulk_downloads : 대량 데이터 다운로드 링크 받기

속도 제한

서버는 OpenFEC API 지침을 준수하기 위해 속도 제한을 구현합니다.

시간당 1000개의 요청
이 제한을 초과하는 요청은 오류 응답을 받게 됩니다.

개발

서버를 수정하려면:

src 디렉토리의 TypeScript 파일을 변경합니다.
서버를 다시 빌드하세요:

npm run build

특허

이 프로젝트는 BSD 3-Clause 라이선스에 따라 라이선스가 부여됩니다. BSD 3-Clause 라이선스는 사용자에게 최대한의 자유를 보장하는 동시에 저작자 표시 요건을 준수하는 관대한 오픈 소스 라이선스입니다. 이 라이선스를 통해 다음과 같은 작업을 수행할 수 있습니다.