tn选举mcp
田纳西州选举的MCP服务器：县竞选财务（EasyVote）、州竞选财务（tncamp）、萨姆纳县基于PDF的披露和州务卿候选人文件。
数据源
EasyVote竞选财务（14个县）
JSON API位于 ecf-api.easyvoteapp.com涵盖了以下县的县级种族（市长、县委员会、学校董事会、市政办公室）：安德森、戴维森、格林、汉布伦、汉密尔顿、诺克斯、麦迪逊、马里恩、莫里、卢瑟福、谢尔比、沙利文、华盛顿、威廉姆森。
tncamp（州级）
HTML抓取 apps.tn.gov/tncamp。涵盖田纳西州所有县的州长、州参议院、州众议院、法官、地方检察官和全州政治行动委员会。
那镇
HTML抓取 votesumnertn.org 用于候选元数据+用于PDF财务数据提取的Gemini Flash。
TN国务卿（候选人申请）
Excel文件来自 sos.tn.gov/elections州和联邦竞选的官方候选人名单：州长、美国参议院、美国众议院、TN参议院、TN众议院和政党执行委员会。这是权威的“谁已申请参选”来源，与竞选财务数据不同。
工具（22）
| 工具 | 来源 | 描述 |
|---|---|---|
list_easyvote_counties | EasyVote | 列出14个有门户网站的县 |
search_county_filers | EasyVote | 在县内搜索候选人/PAC |
list_county_offices | EasyVote | 列出一个县的办事处 |
search_county_contributions | EasyVote | 按捐赠者/接受者搜索捐款 |
search_county_expenditures | EasyVote | 按供应商/候选人搜索支出 |
get_county_election_documents | EasyVote | 获取选举文件 |
search_all_counties_contributions | EasyVote | 跨县捐赠者搜索 |
search_all_counties_expenditures | EasyVote | 跨县供应商搜索 |
search_state_candidates | tncamp | 按姓名或办公室/地区搜索 |
list_tncamp_offices | tncamp | 列出可用的办公室（法院、地方检察官等） |
list_tncamp_districts | tncamp | 列出办公室所在的地区 |
get_candidate_reports | tncamp | 获取归档报告列表 |
get_report_detail | tncamp | 完整财务明细 |
search_state_contributions | tncamp | 跨候选人贡献搜索 |
search_state_expenditures | tncamp | 跨候选人支出搜索 |
get_candidate_financials | tncamp | 快速候选人财务摘要 |
list_sumner_election_cycles | Sumner | 列出选举周期 |
search_sumner_candidates | Sumner | 搜索候选人+PDF链接 |
get_sumner_report | Sumner | 通过Gemini从PDF中提取财务信息 |
search_filed_candidates | TN SOS | 搜索正式提交的候选人 |
list_filed_offices | TN SOS | 列出办公室类别和候选人数量 |
get_filing_summary | TN SOS | 按办公室/政党汇总的归档统计数据 |
安装
npm install -g tn-elections-mcp或者与Claude Code一起使用：
claude mcp add tn-elections -- npx tn-elections-mcp对于萨姆纳县PDF提取，请添加Gemini API密钥：
claude mcp add tn-elections --env GEMINI_API_KEY=your_key -- npx tn-elections-mcp或在 .claude.json:
{
"tn-elections": {
"command": "npx",
"args": ["tn-elections-mcp"],
"env": {
"GEMINI_API_KEY": "your-key-here"
}
}
}如果没有Gemini密钥， get_sumner_report 返回PDF页面图像供Claude直接阅读。
发展
npm run dev # Hot-reload via tsx
npm test # Run tests
npm run build # Compile TypeScript许可证
麻省理工学院