MCP OpenFEC 서버

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

특징

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

요구 사항

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

설치

1. 저장소를 복제합니다.

지엑스피1

2. 종속성 설치:

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

4. 서버를 빌드하세요:

구성

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

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

중요 구성 참고 사항:

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

사용 가능한 도구

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

속도 제한

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

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

개발

서버를 수정하려면:

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

특허

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

• 코드를 상업적으로 사용하세요
• 코드를 수정하세요
• 코드 배포
• 코드를 비공개로 사용하세요

세 가지 주요 조건:

1. 원래 저작권 고지를 포함해야 합니다.
2. 배포판에 라이센스 텍스트를 포함해야 합니다.
3. 허가 없이 기여자의 이름을 사용하여 파생 제품을 보증할 수 없습니다.

BSD 3-Clause 라이선스는 학술 및 상업적 환경에서 널리 사용되며, 허용 범위와 기여자 보호 간의 적절한 균형을 제공합니다.

기여하다

1. 저장소를 포크하세요
2. 기능 브랜치를 생성합니다( git checkout -b feature/my-new-feature )
3. 변경 사항을 커밋합니다( git commit -am 'Add some feature' )
4. 브랜치에 푸시( git push origin feature/my-new-feature )
5. 새로운 풀 리퀘스트 만들기

저작권

저작권 (c) 2025, Phillip Salzman & Foundry Peak, LLC. 모든 권리 보유. 웹사이트: http://foundrypeak.com/

라이센스에 대한 자세한 내용은 LICENSE 파일을 참조하세요.