Civic Data MCP Server

mcp公民数据

AI代理的权威公民和政府数据

     

一 主控程序 将AI代理连接到的服务器 33个免费、权威的公共数据API 涵盖天气、危害、空气质量、水、潮汐、辐射、人口统计、经济、教育、能源、劳工统计、公共卫生、临床试验、行为健康、医疗保健质量、灾害管理、美国环保署环境合规性、美国食品药品监督管理局安全数据、车辆安全、工作场所安全、国家公园、国家森林、消费者金融保护、开放数据发现、网络安全、美国证券交易委员会披露、美联储经济指标、东亚经济账户、BTS运输数据、SBA小企业数据、美国农业部食品和农业数据、美国消防局野火和森林数据以及联邦调查局犯罪/司法统计。

为实用的代理工作流程而构建：简洁的高级工具、重要的原始查询访问以及接受城市名称、邮政编码、地址或原始坐标的位置感知输入。

33个源中的22个不需要API密钥。安装它，将MCP客户端指向它，并开始查询真实的公民数据。

开始使用 · 新增功能 · 数据源 · 工具参考 · 路线图 · 贡献

______________________________________________________________________

开始使用

克劳德桌面/克劳德代码

{
  "mcpServers": {
    "civic-data": {
      "command": "python3",
      "args": ["-m", "mcp_govt_api"],
      "env": {
        "OPENWEATHER_API_KEY": "optional",
        "NASA_API_KEY": "optional",
        "FRED_API_KEY": "optional",
        "BLS_API_KEY": "optional",
        "NPS_API_KEY": "optional",
        "EIA_API_KEY": "optional",
        "BEA_API_KEY": "optional",
        "USDA_API_KEY": "optional",
        "FBI_CDE_API_KEY": "optional"
      }
    }
  }
}

独立

pip install mcp-civic-data
python3 -m mcp_govt_api

______________________________________________________________________

新增功能

• 添加了BJS/FBI犯罪数据浏览器工具，用于犯罪估计、逮捕数据和司法数据集
• 通过WFIGS/ArcGIS添加了美国农业部林务局的工具，用于活跃的野火、火场和国家森林搜索
• 为ECHO设施搜索、详细的设施报告和有毒物质释放清单增加了EPA环境合规工具
• 增加了用于心理健康和药物滥用治疗设施定位器和行为健康数据的SAMHSA工具
• 添加了用于医院质量评级、医疗保险提供者搜索和医疗保健数据的CMS工具
• 通过openFDA添加了用于召回、不良事件和药物标签的FDA工具
• 增加了美国疾病控制与预防中心的公共卫生监测工具，用于疾病跟踪和疫苗接种覆盖率
• 新增了共享地理定位支持 lookup_location 工具
• 升级了天气、地震和空气质量工具，以接受人性化的位置字符串
• 添加了CISA网络安全工具，并将其集成到服务器和README中
• 增加了SEC EDGAR工具，用于归档、提交和公司事实
• 添加了用于安装、编译、单元测试、导入和构建验证的GitHub Actions CI
• 添加 CONTRIBUTING.md, CODE_OF_CONDUCT.md，以及 SECURITY.md
• 增加了东亚银行区域和国民经济账户工具（GDP、收入、行业）
• 增加了分支保护，并要求对 main

______________________________________________________________________

数据源

地球与环境

危险和事件

健康与安全

教育

人口与经济

能量

运输

小型企业

食品与农业

刑事司法

金融与消费者保护

公共卫生

公园与游憩

开放数据目录

钥匙: -- =不需要钥匙。 Optional =无需钥匙即可工作，钥匙解锁更高的速率限制。 Required =启用所需的密钥。

______________________________________________________________________

你可以问什么

"What's the weather forecast for Washington DC?"
"What's the air quality near 10001?"
"Any recent earthquakes near San Francisco?"
"Resolve 1600 Pennsylvania Ave NW to coordinates"
"Are there active fires in Australia?"
"What's the current space weather like?"
"Compare GDP between USA, China, and India"
"What's the population and median income in California?"
"Show me recent photos from the Perseverance rover"
"What are the radiation levels near Fukushima?"
"What are stream flow levels in Colorado?"
"What are the tide predictions for Providence, RI?"
"Find tide stations in Florida"
"Find datasets about climate change on Data.gov"
"What's the current US GDP from FRED?"
"Search FRED for unemployment rate data"
"Get Apple's latest 10-K filing from SEC"
"Show me recent SEC filings for Tesla"
"Search CDC datasets about influenza"
"What are the latest disease surveillance reports for Salmonellosis?"
"Show me vaccination coverage data for Influenza"
"Search for clinical trials on breast cancer"
"Get details for clinical trial NCT04280705"
"How many studies are registered on ClinicalTrials.gov?"
"Are there any known exploited vulnerabilities for Microsoft products?"
"What are the latest CISA security alerts?"
"Show me consumer complaints about mortgages in California"
"What are the most common complaint types filed with the CFPB?"
"What's the current CPI?"
"What's the unemployment rate in California?"
"Show me BLS employment data for 2023"
"What FEMA disaster declarations were made in Florida this year?"
"Show me housing assistance data for Hurricane Ian"
"Search for hospitals in New York with quality ratings"
"What's the quality rating for facility 050001?"
"Find Medicare providers specializing in Cardiology in Texas"
"Show me recent FDA drug recalls in California"
"What adverse events have been reported for aspirin?"
"Get drug label information for ibuprofen"
"Search for national parks in California"
"Are there any alerts at Yosemite?"
"Tell me about Grand Canyon National Park"
"Are there any recalls for 2020 Toyota Camry?"
"Show me consumer complaints for Ford F-150"
"Decode VIN 1HGCM82633A004352"
"Search for school districts in California"
"What's the enrollment at schools in Texas?"
"Find colleges in New York"
"Search for nutritional info on chicken breast"
"What are the detailed nutrients in FDC ID 171688?"
"Show me corn production data for Iowa in 2023"
"What are the current gasoline prices?"
"Show me electricity data for California"
"What energy data categories does the EIA provide?"
"What's California's GDP from BEA?"
"Show me GDP by industry for 2022"
"What datasets does the BEA offer?"
"Show me airline on-time stats for American Airlines"
"What's the border crossing data for El Paso?"
"Search BTS datasets about freight"
"Search SBA datasets for PPP loans"
"What is the SBA size standard for restaurants?"
"Show me SBA disaster loans in Florida"
"Show me OSHA inspections in California"
"What violations were found in OSHA inspection 1234567?"
"Search for workplace fatality reports in Texas"
"Search for EPA-regulated facilities in California"
"Get compliance details for EPA facility 110000350174"
"Show toxic chemical releases in Texas for 2022"
"Find mental health treatment facilities near Chicago"
"Search SAMHSA data for opioid treatment admissions"
"What are the active wildfires in California?"
"Show me wildfire perimeters in Oregon"
"Search for National Forests in Montana"
"What are the crime estimates for California?"
"Show me national arrest data for robbery"
"Search for prisoner statistics datasets"

______________________________________________________________________

工具参考

每个数据源都暴露 高级工具 对于常见查询和a 原始查询工具 API完全访问。

Weather — 5 tools

NOAA Radar & Alerts — 3 tools

Geolocation — 1 tool

Air Quality — 3 tools

Water — 3 tools

Tides & Coastal (NOAA CO-OPS) — 3 tools

EPA (Environmental Compliance) — 3 tools

Earthquakes — 3 tools

Wildfires — 3 tools

Space Weather — 4 tools

Cybersecurity (CISA) — 4 tools

CDC Public Health — 4 tools

ClinicalTrials.gov — 3 tools

CMS Healthcare — 3 tools

FEMA Disasters — 3 tools

USDA Forest Service (USFS) — 3 tools

FDA (openFDA) — 3 tools

SBA (Small Business) — 3 tools

Workplace Safety (OSHA) — 3 tools

NHTSA Vehicle Safety — 3 tools

SAMHSA (Behavioral Health) — 3 tools

SEC EDGAR — 5 tools

Criminal Justice (BJS / FBI CDE) — 3 tools

CFPB Consumer Complaints — 3 tools

National Parks (NPS) — 3 tools

Food & Agriculture (USDA) — 3 tools

Energy (EIA) — 3 tools

Transportation (BTS) — 3 tools

Radiation — 3 tools

Demographics — 4 tools

Economics (World Bank) — 3 tools

Economics (FRED) — 3 tools

Labor Statistics (BLS) — 3 tools

Economics (BEA) — 3 tools

Education (NCES) — 3 tools

NASA — 4 tools

Open Data — 6 tools

______________________________________________________________________

配置

启动时，服务器会打印哪些API可用：

API Availability:
  ✓ NOAA Weather          ✓ Census         ✓ World Bank
  ✓ OpenAQ                ✓ USGS Water     ✓ USGS Earthquakes
  ✓ Safecast              ✓ Data.gov       ✓ EU Open Data
  ✓ Space Weather         ✓ NASA FIRMS     ✓ NASA
  ✓ SEC EDGAR             ✓ CDC Open Data  ✓ EPA ECHO/TRI
  ✓ BLS                   ✓ FEMA
  ✓ SBA                   ✓ CFPB
  ✓ CMS Healthcare        ✓ SAMHSA
  ✗ OpenWeather (key not set)
  ✗ EIA (key not set)
  ✗ BEA (key not set)
  ✗ USDA (key not set)

______________________________________________________________________

实施路线图

第一波

基础

• #48 添加具有回退源的全面错误处理
• #47 为API响应添加智能缓存
• #44 为13个API集成添加单元测试
• #45 将CI/CD扩展到发布和发布自动化

核心数据源

• #55 添加NOAA雷达和预报讨论工具
• #54 添加FRED经济指标工具
• #53 添加美国疾病控制与预防中心公共卫生监测工具
• #56 添加EPA环境合规性和现场工具
• #77 添加NOAA CO-OPS潮汐、洋流和沿海洪水工具

扩展待办事项

公民、卫生和公共服务

• #57 添加BLS劳动力统计工具
• #61 添加FEMA灾难声明和援助工具
• ~~#62 添加ClinicalTrials.gov健康研究工具~~
• #63 添加美国农业部林务局土地和野火工具
• #64 添加司法局统计工具
• #65 添加美国农业部食品和农业数据工具
• #68 添加SAMHSA心理健康和治疗设施工具
• #71 添加NCES教育和学区工具
• #72 添加NHTSA交通安全和碰撞统计工具
• #73 添加OSHA工作场所安全和执法工具
• #78 添加SBA小企业和灾难贷款工具
• #80 添加FDA召回、短缺和安全警报工具
• #84 添加国家公园管理局公园和警报工具

经济、金融和基础设施

• #49 为多源数据聚合添加复合查询
• #59 添加EIA能源市场和电网工具
• ~~#75 添加CFPB消费者投诉和财务保护工具~~
• #79 添加BTS货运和运输绩效工具
• #82 添加SEC文件和公司披露工具
• #83 添加东亚银行区域和国民经济账户工具

延迟/高复杂性集成

• #52 添加GTFS交通和移动工具
• #58 添加FAA机场延误和NAS状态工具
• #60 添加HUD住房和无家可归工具
• #66 添加NREL可再生能源和充电工具
• #67 添加USDA NRCS土壤、积雪和水工具
• #69 添加OpenSecrets竞选财务和游说工具
• #70 添加美国公民及移民服务局移民统计工具
• #76 添加FCC宽带覆盖和互联网接入工具
• #81 添加FEC选举结果和委员会备案工具
• #85 添加美国国际贸易委员会贸易和关税数据工具

积压是有意固执己见的：首先建立强大的共享基础，然后在最高价值的公共数据源中分层，然后进行混乱、标识符繁重或操作繁重的集成。

______________________________________________________________________

发展

git clone https://github.com/EricGrill/mcp-civic-data.git
cd mcp-civic-data
python3 -m pip install -e .
python3 -m mcp_govt_api

验证命令：

python3 -m compileall src
uv run python -m unittest discover -s tests -p "test_*.py"
uv build

贡献

看 贡献.md 用于本地设置、验证和拉取请求指导。

行为准则

贡献者的期望记录在 代码_OF_CONDUCT.md.

安全

请使用中的流程报告漏洞 安全.md.

许可证

麻省理工学院——见 许可证.

______________________________________________________________________