MCP Openfec

🚀 MCP OpenFEC 服務器

MCP OpenFEC 服務器藉助 OpenFEC API，提供聯邦選舉委員會（FEC）競選資金數據的訪問服務，為用戶獲取相關數據提供便利。

🚀 快速開始

MCP OpenFEC 服務器是一個強大的工具，可幫助你訪問聯邦選舉委員會（FEC）的競選資金數據。以下是使用該服務器的基本步驟：

1. 安裝服務器：按照安裝指南完成服務器的安裝。
2. 配置服務器：根據配置說明，將服務器與 Claude Desktop 集成。
3. 使用工具：利用可用工具獲取所需的競選資金數據。

✨ 主要特性

• 🔍 按姓名、州或職位搜索候選人。
• 📄 獲取候選人的詳細信息和財務數據。
• 🏢 訪問委員會信息。
• 💰 查看個人貢獻。
• 📈 跟蹤獨立支出。
• 📁 訪問 FEC 文件和審計案例。
• 📦 下載批量數據。

📦 安裝指南

克隆倉庫

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

安裝依賴項

npm install

添加 API 密鑰

在根目錄創建一個 .env 文件，並添加你的 OpenFEC API 密鑰：

OPENFEC_API_KEY=your_api_key_here

構建服務器

npm run build

💻 使用示例

基礎用法

以下是使用 get_candidate 工具獲取候選人詳細信息的示例：

# 假設你已經啟動了服務器並配置好了環境
# 使用 get_candidate 工具獲取候選人信息
node /absolute/path/to/mcp-openfec/build/server.js get_candidate --candidate_id=12345

高級用法

如果你需要獲取多個候選人的財務數據，可以使用 get_candidate_financials 工具結合循環來實現：

# 假設你有一個候選人 ID 列表 candidate_ids.txt
# 逐行讀取文件並獲取每個候選人的財務數據
while read -r candidate_id; do
    node /absolute/path/to/mcp-openfec/build/server.js get_candidate_financials --candidate_id=$candidate_id
done < candidate_ids.txt

📚 詳細文檔

配置說明

要將此 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": []
    }
  }
}

重要配置注意事項

• 📍 將 /absolute/path/to/mcp-openfec 替換為你實際克隆倉庫的路徑。
• 📏 使用絕對路徑，而不是相對路徑。
• ✅ 設置 disabled 為 false 以啟用服務器。
• 🔒 保留 autoApprove 為空數組以確保安全。
• 🔑 在 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. 修改 package.json 中的依賴項：

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

2. 安裝更新的依賴項：

npm install

📄 許可證

此項目受 MIT License 許可。