MCP OpenFEC 服务器

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

特性

• 按姓名、州或职位搜索候选人
• 获取候选人的详细信息和财务数据
• 访问委员会信息
• 查看个人贡献
• 跟踪独立支出
• 访问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. 修改package.json中的依赖项：

{
  "dependencies": {
    "@microsoft/mcp-openfec-server": "^1.0.0"
  }
}

2. 安装更新的依赖项：

npm install

许可证

此项目受MIT License许可。

以上是完整的中文翻译，仅包含原始内容的信息，没有添加任何额外信息。