MCP OpenFEC Server

MCP OpenFEC Server

一个 Model Context Protocol（MCP）服务，通过 OpenFEC API 提供对联邦选举委员会（FEC）竞选财务数据的访问。

功能

• 按姓名、州或职位搜索候选人
• 获取详细的候选人信息和财务数据
• 访问委员会信息
• 查看个人捐款
• 追踪独立支出
• 访问 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 指南：

• 每小时 1000 次请求
• 超出此限制的请求将收到错误响应

开发

要修改服务：

1. 修改 src 目录中的 TypeScript 文件
2. 重新构建服务：

npm run build

许可证

本项目采用 BSD 3-Clause License 许可，这是一种宽松的开源许可证，确保用户享有最大自由，同时要求保留署名。该许可证允许你：

• 将代码用于商业用途
• 修改代码
• 分发代码
• 私下使用代码

主要有以下三项条件：

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. 创建新的 Pull Request

版权

版权所有 (c) 2025，Phillip Salzman & Foundry Peak, LLC。保留所有权利。网站：http://foundrypeak.com/

许可详情请参阅 LICENSE 文件。