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. リポジトリをクローンします。

git clone https://github.com/psalzman/mcp-openfec
cd mcp-openfec
  1. 依存関係をインストールします:

npm install
  1. ルート ディレクトリに.envファイルを作成し、OpenFEC API キーを追加します。

OPENFEC_API_KEY=your_api_key_here
  1. サーバーを構築します。

npm run build

構成

この MCP サーバーを Claude Desktop で使用するには:

  1. Claude Desktop 構成ファイルを見つけます。

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

    • Windows: %APPDATA%\Claude\claude_desktop_config.json

    • Linux: ~/.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 ガイドラインに準拠するためにレート制限を実装しています。

  • 1時間あたり1000リクエスト

  • この制限を超えるリクエストにはエラー応答が返されます

発達

サーバーを変更するには:

  1. srcディレクトリ内のTypeScriptファイルに変更を加える

  2. サーバーを再構築します。

npm run build

ライセンス

このプロジェクトは、BSD 3条項ライセンス(帰属表示要件を維持しながら、ユーザーに最大限の自由を保証する寛容なオープンソースライセンス)に基づいてライセンスされています。このライセンスでは、以下のことが可能です。

  • コードを商用利用する

  • コードを変更する

  • コードを配布する

  • コードを非公開で使用する

主な条件は 3 つあります。

  1. 元の著作権表示を含める必要があります

  2. 配布物にはライセンステキストを含める必要があります

  3. 許可なく貢献者の名前を使用して派生製品を宣伝することはできません

BSD 3 条項ライセンスは学術および商業の環境で広く使用されており、寛容性と貢献者の保護のバランスが取れています。

貢献

  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. 新しいプルリクエストを作成する

著作権

Copyright (c) 2025, Phillip Salzman & Foundry Peak, LLC. All rights reserved. ウェブサイト: 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