MCP Openfec

🚀 MCP OpenFEC サーバー

このサーバーは、OpenFEC APIを通じて、連邦選挙委員会（FEC）の選挙資金データへのアクセスを提供するモデルコンテキストプロトコル（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. package.jsonの依存関係を変更します：

{
  "dependencies": {
    "@microsoft/mcp-openfec-server": "^1.0.0"
  }
}

2. 更新された依存関係をインストールします：

npm install

📄 ライセンス

このプロジェクトは、MIT Licenseの下でライセンスされています。