AI导哈

联邦选举数据服务

一个通过OpenFEC API提供联邦选举委员会(FEC)竞选财务数据访问的模型上下文协议(MCP)服务器。

  • by psalzman
  • JavaScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 psalzman/mcp-openfec

使用说明

MCP OpenFEC服务器

一种模型上下文协议（MCP）服务器，通过OpenFEC API提供对联邦选举委员会（FEC）竞选财务数据的访问。

特性

  • 按姓名、州或办公室搜索候选人
  • 获取详细的候选人信息和财务数据
  • 准入委员会信息
  • 查看个人贡献
  • 跟踪独立支出
  • 访问FEC文件和审计案例
  • 下载批量数据

需求

安装

  1. 克隆存储库：
git clone https://github.com/psalzman/mcp-openfec
cd mcp-openfec
  1. 安装依赖项：
npm install
  1. 创建一个 .env 文件，并添加您的OpenFEC API密钥：
OPENFEC_API_KEY=your_api_key_here
  1. 构建服务器：
npm run build

配置

要将此MCP服务器与Claude Desktop一起使用：

  1. 找到您的Claude Desktop配置文件：

    • macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
    • 窗户： %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. 在中添加您的OpenFEC API密钥 env 章节

可用工具

  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. 对中的TypeScript文件进行更改 src 目录
  2. 重建服务器：
npm run build

许可证

该项目根据BSD 3-Clause许可证获得许可，这是一种宽松的开源许可证，可确保用户的最大自由，同时保持归因要求。许可证允许您：

  • 商业上使用该代码
  • 修改代码
  • 分发代码
  • 私下使用代码

有三个主要条件：

  1. 您必须附上原始版权声明
  2. 您必须在发行版中包含许可证文本
  3. 未经许可，您不能使用贡献者的姓名来背书衍生产品

BSD 3条款许可证广泛应用于学术和商业环境中，在允许性和保护贡献者之间提供了良好的平衡。

贡献

  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请求

版权

Phillip Salzman&Foundry Peak，LLC版权所有（c）2025。保留所有权利。网状物： http://foundrypeak.com/

有关许可的详细信息，请参阅 许可证 文件。

相关 MCP