MCP OpenFEC 服务器

一个模型上下文协议 (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 许可证获得许可 - 一种宽松的开源许可证，可确保用户的最大自由，同时保持署名要求。 该许可证允许您：

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

具有三个主要条件：

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

BSD 3-Clause 许可证广泛用于学术和商业环境，在许可性和保护贡献者之间取得了良好的平衡。

贡献

1. Fork 存储库
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。 保留所有权利。 网址：<a href="http://foundrypeak.com">http://foundrypeak.com/</a>

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