Skip to main content
Glama
MCP OpenFEC Server

MCP OpenFEC Server

by psalzman

MCP OpenFEC 서버

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

특징

  • 이름, 주 또는 직책별로 후보자 검색

  • 후보자에 대한 자세한 정보와 재무 데이터를 얻으세요

  • 접근위원회 정보

  • 개별 기여 보기

  • 독립적인 지출을 추적하세요

  • FEC 제출 및 감사 사례에 접근하세요

  • 대량 데이터 다운로드

Related MCP server: FireHydrant MCP Server

요구 사항

설치

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

지엑스피1

  1. 종속성 설치:

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

OPENFEC_API_KEY=your_api_key_here
  1. 서버를 빌드하세요:

npm run build

구성

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. 다음 구성을 파일에 추가합니다.

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

중요 구성 참고 사항:

  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. 서버를 다시 빌드하세요:

npm run build

특허

이 프로젝트는 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 파일을 참조하세요.

Available Tools

12 tools
get_audit_casesC

Get FEC audit cases and findings

Inputs: committee_id, audit_id, audit_year, finding_types.

get_bulk_downloadsB

Get links to bulk data downloads

Inputs: data_type (required), election_year.

get_candidateC

Get detailed information about a candidate

Inputs: candidate_id (required), election_year.

get_candidate_contributionsC

Get individual contributions for a candidate

Inputs: candidate_id (required), election_year, sort.

get_candidate_financialsC

Get financial data for a candidate

Inputs: candidate_id (required), election_year (required).

get_committeeC

Get detailed information about a committee

Inputs: committee_id (required).

get_communication_costsC

Get corporate/union communication costs

Inputs: committee_id, candidate_id, min_date, max_date, +3 more.

get_electioneeringC

Get electioneering communications

Inputs: committee_id, candidate_id, min_date, max_date, +3 more.

get_filingsC

Retrieve official FEC filings with filters

Inputs: committee_id, candidate_id, form_type, min_receipt_date, +3 more.

get_independent_expendituresC

Get independent expenditures supporting or opposing candidates

Inputs: candidate_id, committee_id, support_oppose_indicator, min_date, +4 more.

get_party_coordinated_expendituresD

Get party coordinated expenditures

Inputs: committee_id, candidate_id, min_date, max_date, +3 more.

search_candidatesC

Search for candidates by name or other criteria

Inputs: name (required), state, office, election_year.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.1/5.0

    Scored across 12 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose targeting specific FEC data types like candidates, committees, contributions, expenditures, filings, and downloads. There is no overlap in functionality—tools like get_candidate, get_committee, and get_filings serve separate resources, and even related tools like get_candidate_contributions and get_candidate_financials focus on different aspects of candidate data.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern using snake_case, starting with 'get_' or 'search_' followed by a specific noun phrase (e.g., get_candidate, search_candidates, get_audit_cases). This uniformity makes the tool set predictable and easy to navigate, with no deviations in naming style.

    Tool Count5/5

    With 12 tools, the server is well-scoped for accessing U.S. Federal Election Commission data, covering key areas like candidates, committees, financials, expenditures, and filings. Each tool serves a distinct data retrieval function, avoiding bloat while providing comprehensive coverage for the domain.

    Completeness4/5

    The tool set offers strong coverage for retrieving FEC data, including candidates, committees, financials, expenditures, filings, and bulk downloads. A minor gap exists in update or management operations (e.g., no create or modify tools), but this is reasonable for a read-only data access server focused on public records, and agents can work effectively with the provided retrieval functions.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers