🚀 MCP OpenFEC 服务器
MCP OpenFEC 服务器是一个借助 OpenFEC API 提供服务的模型上下文协议（MCP）服务器，可让用户轻松访问联邦选举委员会（FEC）的竞选资金数据。
🚀 快速开始
MCP OpenFEC 服务器为用户提供便捷的联邦选举委员会竞选资金数据访问服务。以下将详细介绍其使用步骤。
✨ 主要特性
- 🔍 按姓名、州或职位搜索候选人。
- 📄 获取候选人的详细信息和财务数据。
- 🏢 访问委员会信息。
- 💰 查看个人贡献。
- 📈 跟踪独立支出。
- 📁 访问 FEC 文件和审计案例。
- 💾 下载批量数据。
📦 安装指南
- 克隆仓库：
git clone https://github.com/psalzman/mcp-openfec
cd mcp-openfec
- 安装依赖项：
npm install
- 在根目录创建一个
.env文件，并添加你的 OpenFEC API 密钥：
OPENFEC_API_KEY=your_api_key_here
- 构建服务器：
npm run build
📚 详细文档
配置
要将此 MCP 服务器与 Claude Desktop 一起使用：
-
找到你的 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
- macOS:
-
将以下配置添加到文件中：
{
"mcpServers": {
"openfec": {
"command": "node",
"args": ["/absolute/path/to/mcp-openfec/build/server.js"],
"env": {
"OPENFEC_API_KEY": "your_api_key_here"
},
"disabled": false,
"autoApprove": []
}
}
}
⚠️ 重要提示
- 将
/absolute/path/to/mcp-openfec替换为你实际克隆仓库的路径。- 使用绝对路径，而不是相对路径。
- 设置
disabled为false以启用服务器。- 保留
autoApprove为空数组以确保安全。- 在
env部分添加你的 OpenFEC API 密钥。
可用工具
get_candidate: 获取候选人的详细信息。get_candidate_financials: 获取候选人的财务数据。search_candidates: 按姓名或其他标准搜索候选人。get_committee: 获取委员会的详细信息。get_candidate_contributions: 获取候选人的个人贡献。get_filings: 获取官方 FEC 文件。get_independent_expenditures: 获取独立支出。get_electioneering: 获取选举宣传通信。get_party_coordinated_expenditures: 获取政党协调支出。get_communication_costs: 获取企业和工会的通信费用。get_audit_cases: 获取 FEC 审计案例和结果。get_bulk_downloads: 获取批量数据下载链接。
限流措施
服务器实现了限流以符合 OpenFEC API 指南：
- 每小时 1000 个请求。
- 超过限制的请求将收到错误响应。
开发
要修改服务器：
- 修改
package.json中的依赖项：
{
"dependencies": {
"@microsoft/mcp-openfec-server": "^1.0.0"
}
}
- 安装更新的依赖项：
npm install
📄 许可证
此项目受 MIT License 许可。