选举财务数据服务

提供田纳西州选举的县级和州级竞选财务数据服务,包括候选人申报、捐款和支出搜索等功能。

  • by asreynolds1000
  • HTML
  • 本地部署
  • 更新于
在 GitHub 查看 asreynolds1000/tn-elections-mcp

使用说明

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

许可证

麻省理工学院