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 许可。