MCP OpenFEC Server

MCP OpenFEC Server

OpenFEC API を通じて連邦選挙委員会（FEC）の選挙資金データにアクセスできる、Model Context Protocol（MCP）サーバーです。

機能

• 候補者を名前、州、または役職で検索
• 候補者の詳細情報と財務データを取得
• 委員会情報にアクセス
• 個人からの献金を表示
• 独立支出を追跡
• FEC の提出書類と監査案件にアクセス
• 一括データをダウンロード

要件

• Node.js（v16 以上）
• OpenFEC API キー（こちらから取得）

インストール

1. リポジトリをクローンします：

git clone https://github.com/psalzman/mcp-openfec
cd mcp-openfec

2. 依存関係をインストールします：

npm install

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

OPENFEC_API_KEY=your_api_key_here

4. サーバーをビルドします：

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-Clause License の下でライセンスされています。これは、帰属表示の要件を維持しながら、ユーザーに最大限の自由を保証する寛容なオープンソースライセンスです。このライセンスでは、次のことが認められています：

• コードを商用利用する
• コードを変更する
• コードを配布する
• コードを非公開で使用する

主な条件は次の 3 つです：

1. 元の著作権表示を含める必要があります
2. 配布物にライセンス本文を含める必要があります
3. 許可なく、派生製品を推奨する目的で貢献者の名前を使用することはできません

BSD 3-Clause License は学術分野や商用分野で広く使用されており、寛容さと貢献者の保護とのバランスに優れています。

貢献

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. Web: http://foundrypeak.com/

ライセンスの詳細については、LICENSE ファイルをご覧ください。