MCP OpenFEC Server

MCP OpenFEC 服务器

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

特征

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

要求

• Node.js（v16 或更高版本）
• OpenFEC API 密钥（在此获取）

安装

1. 克隆存储库：

2. 安装依赖项：

3. 在根目录中创建一个.env文件并添加您的 OpenFEC API 密钥：

4. 构建服务器：

配置

要将此 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. 在文件中添加以下配置：

重要配置说明：

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. 重建服务器：

执照

本项目遵循 BSD 三条款许可证，这是一个宽松的开源许可证，在确保用户最大自由度的同时，满足署名要求。该许可证允许您：

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

主要有三个条件：

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

版权

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

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