政府数据API服务

一个连接AI代理与34个权威公共数据API的MCP服务器,涵盖天气、灾害、空气质量、水、潮汐、辐射、人口统计、经济学、教育、能源、劳动统计、公共卫生、临床试验、行为健康、医疗质量、灾害管理等领域。

  • by EricGrill
  • Python
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 EricGrill/mcp-civic-data

使用说明

mcp公民数据

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

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

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

34个源中的23个不需要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、收入、行业)
  • 增加了FAA公共航空工具,用于AIS地理数据、TFR、NAS状态、飞机登记和飞机类型特征
  • 增加了分支保护,并要求对 main

数据源

地球与环境

来源 涵盖内容 关键
美国国家海洋和大气管理局天气 美国天气预报,恶劣天气警报 --
开放天气 任何城市的全球天气 必填
OpenAQ 全球各监测站的空气质量 --
美国地质调查局水务 美国每条河流的实时流量和洪水位 --
NOAA合作社 潮汐预测、观测水位、沿海观测站 --
美国环保署ECHO/环境事实 设施合规性、执行历史、有毒物质排放(TRI) --
Safecast 社区辐射监测,150M+测量 --

危险和事件

来源 涵盖内容 关键
美国地质调查局地震 地球上的每一次地震,实时 --
美国国家航空航天局公司 从卫星探测到的活跃野火 可选
美国国家海洋和大气管理局空间天气 太阳风、地磁风暴、太阳耀斑 --
网络安全和基础设施安全局 已知被利用的漏洞、安全警报、警告 --
联邦应急管理局 灾害申报、援助数据、住房援助 --
美国财政部(WFIGS) 活跃的野火、火灾边界、国家森林边界 --

健康与安全

来源 涵盖内容 关键
内容管理系统 医院质量评级、医疗保险提供者搜索、医疗保健数据 --
FDA(openFDA) 药品/食品/器械召回、不良事件、药品标签 --
药物滥用与心理健康服务管理局 心理健康和药物滥用治疗设施,行为健康数据 --
美国国家公路交通安全管理局 车辆召回、消费者投诉、VIN解码 --
OSHA(DOL) 工作场所检查、违规行为、死亡报告 --
ClinicalTrials.gov 临床研究搜索、试验详情、数据库统计 --

教育

来源 涵盖内容 关键
NCES(教育数据门户) 学区、学校招生、学院/大学数据 --

人口与经济

来源 涵盖内容 关键
美国人口普查 美国每个县的人口、人口统计、住房 --
世界银行 200多个国家的国内生产总值、贫困、失业率 --
弗雷德 美联储经济数据:GDP、通货膨胀、就业、利率 必填
美国劳工统计局 CPI、失业、就业、劳动统计 可选
美国经济分析局 地区GDP、个人收入、按行业划分的GDP 必填

能量

来源 涵盖内容 关键
环境影响评估 电力、石油、天然气、煤炭和能源市场数据 必填

运输

来源 涵盖内容 关键
防弹少年团 航空公司准点率、过境数据、运输数据集 --
FAA公共航空数据 AIS机场/地理数据、TFR、NAS状态、飞机登记处、飞机特征、FAA目录 --

小型企业

来源 涵盖内容 关键
SBA公司 小企业规模标准、灾难贷款、开放数据集 --

食品与农业

来源 涵盖内容 关键
美国农业部 食品营养数据(FoodData Central)、作物产量和种植面积(NASS) 必填

刑事司法

来源 涵盖内容 关键
联邦调查局CDE/BJS 通过联邦调查局犯罪数据浏览器进行犯罪估计、逮捕数据、司法数据集 必填

金融与消费者保护

来源 涵盖内容 关键
第二埃德加 公司文件,10-K、10-Q、8-K表格 --
消费者金融保护局 消费者投诉、金融产品问题、公司回应 --

公共卫生

来源 涵盖内容 关键
美国疾病控制与预防中心开放数据 疾病监测、疫苗接种覆盖率、公共卫生数据集 --

公园与游憩

来源 涵盖内容 关键
净推荐值 国家公园、警报、关闭、公园详细信息 必填

开放数据目录

来源 涵盖内容 关键
Data.gov 300000多个美国政府数据集 --
欧盟开放数据 欧盟数据集,多语言 --
美国国家航空航天局 APOD,火星车照片,图像/视频库 可选

钥匙: -- =不需要钥匙。 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"
"Are there active TFRs in Virginia?"
"Look up FAA airport and runway data for LAX"
"Is DCA currently affected by FAA NAS delays or closures?"
"Look up FAA aircraft registration N23FX"
"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
工具 说明
get_weather_forecast 按地名或坐标对美国位置进行7天预测
get_weather_alerts 按州划分的活跃恶劣天气警报
get_global_weather 全球任何城市的现状
query_noaa NOAA API原始访问
query_openweather 原始OpenWeather API访问
NOAA Radar & Alerts — 3 tools
工具 说明
get_forecast_discussion NWS气象预报办公室区域预报讨论
get_active_weather_alerts 按状态、事件类型和严重程度过滤的活动天气警报
get_radar_stations NEXRAD雷达站,可选择按州过滤
Geolocation — 1 tool
工具 说明
lookup_location 将城市、邮政编码、地址或坐标解析为标准化位置
Air Quality — 3 tools
工具 说明
get_air_quality 地名或坐标附近站点的当前读数
get_air_quality_history 监测站的历史测量
query_openaq 原始OpenAQ v3 API访问
Water — 3 tools
工具 说明
get_water_conditions 美国各州的河流流量和水位高度
get_water_site 特定美国地质调查局监测点的所有读数
query_usgs_water 美国地质勘探局原水服务API接入
Tides & Coastal (NOAA CO-OPS) — 3 tools
工具 说明
get_tide_predictions CO-OPS站的潮汐预测
get_water_levels 从CO-OPS站观测到的水位
search_tide_stations 搜索NOAA CO-OPS潮汐预报站
EPA (Environmental Compliance) — 3 tools
工具 说明
search_epa_facilities 通过ECHO执法数据库搜索EPA监管的设施
get_epa_facility_info 通过注册表ID获取设施的详细合规信息
get_toxic_releases 通过Envirofacts查询有毒物质释放清单(TRI)数据
Earthquakes — 3 tools
工具 说明
get_recent_earthquakes 近期全球地震超过震级阈值
get_earthquakes_near 地名或坐标附近最近发生的地震
query_earthquakes 原始美国地质勘探局地震API访问
Wildfires — 3 tools
工具 说明
get_active_fires 某一地点附近的火灾和热点
get_country_fires 整个国家的活跃火灾(ISO alpha-3)
query_firms 原始NASA FIRMS API访问
Space Weather — 4 tools
工具 说明
get_space_weather_summary 太阳风速、Kp指数、NOAA风暴等级
get_solar_flares 最近的太阳耀斑活动和分类
get_space_weather_alerts 活跃的NOAA空间天气警报和警告
query_space_weather 原始SWPC API访问
Cybersecurity (CISA) — 4 tools
工具 说明
search_known_exploited_vulnerabilities 搜索CISA的主动利用漏洞目录
get_recent_cisa_alerts 最近的CISA安全警报和建议
get_cisa_bulletins 主要供应商每周发布的CISA漏洞摘要
query_cisa_kev 原始CISA已知漏洞目录访问
CDC Public Health — 4 tools
工具 说明
search_cdc_datasets 按关键字搜索美国疾病控制与预防中心的开放数据目录
get_cdc_disease_surveillance NNDSS的法定传染病病例数
get_cdc_vaccination_coverage 按疫苗和州分列的疫苗接种覆盖率估计
query_cdc_open_data 任何数据集的原始CDC SODA API访问
ClinicalTrials.gov — 3 tools
工具 说明
search_clinical_trials 按关键字、条件、干预或状态搜索临床研究
get_clinical_trial 通过NCT ID获取特定试验的详细方案信息
get_trial_statistics 获取ClinicalTrials.gov数据库的整体统计数据
CMS Healthcare — 3 tools
工具 说明
search_hospitals 按名称或州搜索具有整体质量评级的医院
get_hospital_quality 获取特定医院的详细质量指标和评级
search_medicare_providers 按姓名、州或专业搜索联邦医疗保险注册的医疗服务提供者
FEMA Disasters — 3 tools
工具 说明
get_fema_disasters 按州、年份或类型搜索灾难声明
get_fema_disaster_summary 特定灾难编号的详细摘要
get_fema_assistance 灾难幸存者住房援助数据
USDA Forest Service (USFS) — 3 tools
工具 说明
get_active_wildfires 按州分列的WFIGS当前野火事件
get_wildfire_perimeters 主动火灾周界和面积边界
search_national_forests 按名称或州搜索国家森林
FDA (openFDA) — 3 tools
工具 说明
search_fda_recalls 搜索美国食品药品监督管理局药品、食品和设备召回/执行报告
get_fda_adverse_events 从FAERS搜索药物不良事件报告
get_fda_drug_labels 搜索药物标签和SPL数据(适应症、警告、剂量)
SBA (Small Business) — 3 tools
工具 说明
search_sba_datasets 在data.SBA.gov上搜索SBA开放数据集
get_sba_size_standards 按行业或NAICS代码查找小型企业规模标准
get_sba_disaster_loans 按州或年份获取SBA灾难贷款数据
Workplace Safety (OSHA) — 3 tools
工具 说明
search_osha_inspections 按州或机构搜索OSHA工作场所检查
get_osha_violations 获取特定OSHA检查的违规行为
search_osha_fatalities 搜索工作场所死亡和灾难报告
NHTSA Vehicle Safety — 3 tools
工具 说明
search_vehicle_recalls 按品牌、型号和年份搜索NHTSA车辆召回活动
get_vehicle_complaints 从NHTSA获取消费者对车辆的投诉
decode_vin 解码品牌/型号/年份/规格的车辆识别号
SAMHSA (Behavioral Health) — 3 tools
工具 说明
find_treatment_facilities 查找附近的心理健康和药物滥用治疗机构
search_samhsa_datasets 在SAMHSA开放数据目录中搜索行为健康数据集
get_samhsa_facility_details 获取特定SAMHSA治疗设施的详细信息
SEC EDGAR — 5 tools
工具 说明
get_company_filings 通过股票代码或CIK(10-K、10-Q、8-K)获取SEC文件
search_company 按名称或股票代码指南查找公司CIK
get_latest_submissions 按表单类型筛选最近提交的内容
get_company_facts 获取公司事实和XBRL财务数据
query_sec_edgar 原始SEC EDGAR API访问
Criminal Justice (BJS / FBI CDE) — 3 tools
工具 说明
get_crime_estimates 联邦调查局UCR项目按州或国家分列的犯罪估计
get_arrest_data 按犯罪类型分列的全国逮捕数据
search_crime_datasets 在Data.gov上搜索犯罪和司法数据集
CFPB Consumer Complaints — 3 tools
工具 说明
search_cfpb_complaints 按产品、公司、州或关键字搜索消费者投诉
get_cfpb_complaint 按ID获取特定消费者投诉的完整详细信息
get_cfpb_complaint_stats 按产品、公司或州汇总投诉统计数据
National Parks (NPS) — 3 tools
工具 说明
search_national_parks 按名称、关键字或州代码搜索公园
get_park_alerts 公园的主动警报(关闭、警告、危险)
get_park_info 详细的公园信息,包括时间、费用和联系方式
Food & Agriculture (USDA) — 3 tools
工具 说明
search_usda_foods 在FoodData Central中搜索食品的营养信息
get_food_details 通过FDC ID获取特定食物的详细营养数据
get_crop_data 按州和年份获取NASS作物产量、种植面积和产量数据
Energy (EIA) — 3 tools
工具 说明
get_electricity_data 按州划分的零售电力销售、价格和收入
get_petroleum_prices 汽油、柴油和取暖油价格数据
get_energy_overview 浏览可用的EIA数据类别和路线
Transportation (BTS) — 3 tools
工具 说明
get_airline_ontime_stats 航空公司准点率、延误和取消
get_border_crossing_data 美国-加拿大和美国-墨西哥边境入境数据
search_bts_datasets 在data.BTS.gov上搜索BTS开放数据集
Radiation — 3 tools
工具 说明
get_radiation_measurements 某一位置附近的辐射读数
get_radiation_history 带日期范围过滤的辐射历史
query_safecast 原始Safecast API访问
Demographics — 4 tools
工具 说明
get_population 按州或县划分的人口
get_demographics 年龄、种族、收入明细
get_housing_stats 房屋价值、租金、空置率
query_census 带有自定义变量的原始人口普查API
Economics (World Bank) — 3 tools
工具 说明
get_country_indicators 任何国家的国内生产总值、人口、贫困
compare_countries 比较多个国家的指标
query_worldbank 世界银行API原始访问
Economics (FRED) — 3 tools
工具 说明
search_fred_series 按关键字搜索经济数据系列
get_fred_series 获取一系列的观测值(例如,GDP、UNRATE、CPIAUCSL)
get_fred_series_info 获取有关系列的元数据
Labor Statistics (BLS) — 3 tools
工具 说明
get_bls_timeseries 获取任何BLS系列(CPI、就业、PPI)的时间序列数据
search_bls_series 按关键字查找常见的BLS系列ID
get_unemployment_rate 全国或州级失业率数据
Economics (BEA) — 3 tools
工具 说明
get_bea_regional_data 按州分列的地区GDP、收入和就业数据
get_bea_gdp_by_industry 按行业划分的GDP明细
search_bea_datasets 列出可用的BEA数据集和表格
Education (NCES) — 3 tools
工具 说明
search_school_districts 按州或名称搜索学区
get_school_enrollment 按州或地区获取学校入学数据
search_colleges 通过IPEDS搜索学院和大学
NASA — 4 tools
工具 说明
get_astronomy_photo 当日天文图片
get_mars_rover_photos 来自好奇、毅力等的照片
search_nasa_images 搜索美国国家航空航天局的图像和视频库
query_nasa 原始NASA API访问
FAA Aviation — 22 tools
工具 说明
search_faa_airports 按标识符、名称、城市或州搜索FAA AIS机场地理数据
get_faa_airport 按FAA标识符或ICAO ID列出的FAA AIS机场详细信息
get_faa_runways FAA机场AIS跑道记录
get_faa_airspace_near 坐标附近的FAA级和特殊用途空域
get_faa_uas_facility_map 美国联邦航空局无人机设施地图坐标附近记录
query_faa_ais 原始边界FAA AIS ArcGIS FeatureServer查询
get_faa_tfrs 带有可选过滤器的主动FAA临时飞行限制
get_faa_tfr_summary FAA按中心/设施统计的TFR
get_faa_tfr_shapes 主动FAA TFR GeoJSON样式形状
get_faa_tfr_detail 解析FAA TFR详细XML以获取NOTAM ID
get_faa_nas_airport_events 当前FAA NAS机场事件
get_faa_ground_stops 当前FAA NAS地面停靠事件
get_faa_ground_delays 当前FAA NAS地面延迟事件
get_faa_airport_closures 当前FAA NAS机场关闭事件
get_faa_operations_plan 当前FAA NAS运营计划JSON
get_faa_artcc_boundaries FAA NAS ARTCC边界数据
lookup_faa_aircraft_registration 按N编号查找有界FAA飞机登记处
search_faa_aircraft_registry 按品牌/型号/状态/状态搜索有限的FAA飞机登记处
get_faa_aircraft_type_characteristics FAA飞机类型特征查找
search_faa_aircraft_type_characteristics FAA飞机类型特征搜索
search_faa_catalog FAA数据目录CKAN搜索
query_faa_catalog 原始FAA数据目录CKAN查询
Open Data — 6 tools
工具 说明
search_datasets 搜索300000多个美国政府数据集
get_dataset_info 数据集元数据和下载链接
query_datagov 原始CKAN API访问
search_eu_datasets 搜索欧盟数据集
get_eu_dataset_info 欧盟数据集详细信息和分布
query_eu_data 欧盟原始数据门户API访问

FAA来源说明

第一波FAA工具使用公共非关键来源:

来源 终点家族 新鲜度 警告
FAA AIS ArcGIS功能服务器 services6.arcgis.com/.../FeatureServer FAA AIS发布周期;服务元数据公开编辑日期 仅提供信息性地理数据
FAA-TFR tfr.faa.gov/tfrapi 和GeoServer WFS 主动FAA TFR站点数据 在操作使用前验证官方FAA/简报来源
FAA NAS状态 nasstatus.faa.gov/api 当前NAS状态API数据 状态数据可以快速更改
美国联邦航空局飞机登记处 registry.faa.gov/database/ReleasableAircraft.zip 每日公共ZIP下载 公共记录可能包括所有者信息;搜索是有界限的
FAA飞机特性 FAA可下载工作簿 FAA发布的工作簿更新节奏 类型特性,而不是单个飞机或现场操作
FAA数据目录 catalog.data.faa.gov/api/3 目录元数据更新节奏 仅限发现;资源各不相同

FAA航空工具仅供参考。在做出运营决策之前,核实美国联邦航空局、航行通告、海图和飞行简报的官方来源。飞机登记工具使用美国联邦航空局的公共记录,并限制搜索范围,因为登记数据可能包括所有者信息。

推迟FAA相邻集成:

  • 美国联邦航空管理局开发门户网站产品:需要美国联邦航空局账户/API密钥。
  • FAA SWIM:需要访问协议。
  • 完整NOTAM搜索/NMS抓取:推迟;TFR数据是第一波NOTAM子集。
  • 美国国家海洋和大气管理局航空气象中心:有用的航空气象数据,但不是美国联邦航空局拥有的。
  • 美国联邦航空局野生动物打击API:推迟到生产主机名和公开使用条款得到确认;不包括POST/add/update/upload端点。

配置

变量 目的 默认值
OPENWEATHER_API_KEY 启用全球天气工具 (残疾)
NASA_API_KEY NASA+FIRMS的速率限制更高 DEMO_KEY (30个要求/小时)
FRED_API_KEY 启用FRED经济数据工具 (残疾)
BLS_API_KEY BLS的费率上限更高(每天25至500次查询) (无钥匙工作)
NPS_API_KEY 启用国家公园管理局工具 (残疾)
EIA_API_KEY 启用EIA能源市场工具 (残疾)
BEA_API_KEY 启用东亚银行经济账户工具 (残疾)
USDA_API_KEY 启用美国农业部食品营养和作物数据工具 (残疾)
FBI_CDE_API_KEY 启用FBI犯罪数据浏览器/BJS犯罪工具 (残疾)
API_TIMEOUT 请求超时(秒) 30
MCP_CIVIC_DATA_CACHE_DIR FAA注册表/工作簿下载的可选缓存根 ~/.cache/mcp-civic-data

启动时,服务器会打印哪些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
  ✓ FAA Public Aviation Data
  ✗ OpenWeather (key not set)
  ✗ EIA (key not set)
  ✗ BEA (key not set)
  ✗ USDA (key not set)

实施路线图

活跃的路线图存在于 #87 第一个交付里程碑是 第一波:基础+核心数据。下面的积压反映了GitHub问题中的实施计划。

第一波

基础

  • #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.

许可证

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