MCP OpenFEC Server

基本能力

产品定位

MCP OpenFEC Server 是一个专门用于访问和处理联邦选举委员会 (FEC) 竞选财务数据的服务。

核心功能

• 按名称、州或职位搜索候选人
• 获取详细的候选人信息和财务数据
• 访问委员会信息
• 查看个人捐款
• 跟踪独立支出
• 访问 FEC 文件和审计案例
• 下载批量数据

适用场景

• 政治竞选财务分析
• 选举数据研究
• 政治透明度报告
• 竞选资金追踪

工具列表

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 个请求
• 超过此限制的请求将收到错误响应

使用教程

使用依赖

• Node.js (v16 或更高版本)
• OpenFEC API 密钥 (获取地址)

安装教程

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

调试方式

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

npm run build

许可证

该项目遵循 BSD-3-Clause 开源许可条款，请参阅 BSD-3-Clause 了解完整条款。