非官方CDC MCP服务器
一个全面的MCP(模型上下文协议)服务器,通过Socrata开放数据API(SODA)提供对CDC(疾病控制和预防中心)公共卫生数据的访问。
数据集总数:73(无需身份验证) 监视系统:18个不同的疾病预防控制中心项目 卫生措施:慢性病、行为风险、环境健康、疫情检测、疫苗接种和药物过量等100多个指标
特性
- TypeScript实现:使用@modelcontextprotocol/sdk构建
- 全面覆盖:18个监测系统的73个公共数据集
- 统一接口:单一工具,18种专业方法
- 实时监控:NNDSS对50多种法定传染病进行疫情检测
- 新冠肺炎疫苗接种:使用公平指标(SVI,城市/农村)进行县级跟踪
- 药物过量危机:实时监测药物特异性跟踪(芬太尼、阿片类药物)
- 速率限制:内置速率限制(500ms延迟),以遵守API配额
- 应用令牌支持:使用有效的应用程序令牌增强速率限制(1000个请求/小时)
- 灵活查询:支持过滤、分页和自定义SoQL查询
- 100%公共数据:所有数据集无需身份验证即可访问
可用数据源
数据集覆盖率(共73个)
| 类别 | 数据集 | 主要功能 |
|---|---|---|
| 地方 | 5 | 县、地、道、ZCTA(40+卫生措施) |
| BRFSS | 7 | 2011年至今综合+1995-2010年历史 |
| 危险行为监测系统 | 2 | 青少年健康监测(药物使用、心理健康) |
| 呼吸的 | 2 | 呼吸道合胞病毒/新冠病毒/流感+呼吸道合胞菌特异性 |
| 疫苗接种 | 5 | 青少年、孕妇、幼儿园、所有年龄段的流感、呼吸道合胞病毒 |
| 生命统计 | 5 | 出生、死亡、产妇、婴儿统计 |
| 环境的 | 2 | 空气质量、水氟化 |
| 烟草 | 6 | 经济影响+5种政策类型 |
| 受伤 | 2 | TBI监测,酒精受损驾驶 |
| 传染病 | 2 | 肺炎球菌,食源性/水性 |
| 母婴 | 3 | 母乳喂养、PRAMS、出生统计 |
| 口头/视觉 | 2 | NOHSS口腔健康,BRFSS视力 |
| 营养 | 3 | 行为、政策、青年特有 |
| 疾病特异性 | 4 | 心脏病、糖尿病、癌症、新冠肺炎 |
| 历史的 | 1 | ACA前的医疗保健可及性(1995-2010) |
| NNDSS | 14 | 实时疫情检测(50多种法定传染病) |
| 新冠肺炎疫苗接种 | 4 | 使用公平指标进行县级跟踪 |
| 药物过量 | 6 | 按药物类型列出的临时+最终过量数据 |
用法
{
"mcpServers": {
"cdc-mcp-server": {
"command": "node",
"args": ["/path/to/cdc-mcp-server/build/index.js"],
"env": {
"CDC_APP_TOKEN": "your_app_token_here"
}
}
}
}备注:The CDC_APP_TOKEN 环境变量是可选的,但建议用于增强的速率限制(与共享池相比为1000 req/小时)。
MCP方法
核心方法(5)
1. list_datasets
列出所有53个可用的CDC数据集。
{
"method": "list_datasets"
}2. get_places_data
获取PLASES当地疾病流行率数据(40+健康指标)。
参数:
geography_level:“县”、“地点”、“地块”、“zcta”(默认值:“郡”)year:“2023”、“2024”(默认值:“2024)state:州缩写(例如“CA”、“TX”)measure_id:疾病测量(例如,“糖尿病”、“肥胖”、“冠心病”)location:特定位置名称limit:最大结果(默认值:100)offset:分页偏移量(默认值:0)
示例:
{
"method": "get_places_data",
"geography_level": "county",
"year": "2024",
"state": "CA",
"measure_id": "DIABETES"
}3. get_brfss_data
获取BRFSS行为风险因素数据。
参数:
dataset_type:“肥胖_国家”、“肥胖_状态”、“糖尿病”、“哮喘”year:具体年份state:州缩写limit,offset:分页
示例:
{
"method": "get_brfss_data",
"dataset_type": "diabetes",
"year": 2023,
"state": "NY"
}4. search_dataset
使用自定义SoQL查询在任何CDC数据集中进行通用搜索。
参数:
dataset_name:数据集标识符(必填)select_fields:要返回的字段where_clause:SoQL WHERE子句order_by:排序字段limit,offset:分页
示例:
{
"method": "search_dataset",
"dataset_name": "breastfeeding_nis",
"where_clause": "state='Texas'",
"limit": 100
}5. get_available_measures
列出特定数据集的所有可用度量值。
示例:
{
"method": "get_available_measures",
"dataset_name": "places_county_2024"
}______________________________________________________________________
一级方法:高优先级健康监测(7)
6. get_yrbss_data
青少年危险行为监测(药物使用、心理健康、暴力)。
参数:
state:州缩写topic:“物质使用”、“心理健康”、“暴力”、“性行为”、“营养”、“身体活动”year:调查年份limit,offset:分页
示例:
{
"method": "get_yrbss_data",
"state": "CA",
"topic": "mental_health",
"year": 2023
}7. get_respiratory_surveillance
呼吸道合胞病毒/新冠肺炎/流感联合住院监测。
参数:
virus:“rsv”、“新冠肺炎”、“流感”、“组合”(默认值:“组合”)state:管辖权year:年份过滤器limit,offset:分页
示例:
{
"method": "get_respiratory_surveillance",
"virus": "rsv",
"state": "NY",
"year": 2024
}8. get_vaccination_coverage
按年龄组分列的疫苗接种率。
参数:
age_group:“青少年”、“孕妇”、“幼儿园”(必填)state:州缩写vaccine_type:“hpv”、“tdap”、“menacwy”、“流感”year:调查年份limit,offset:分页
示例:
{
"method": "get_vaccination_coverage",
"age_group": "teen",
"state": "TX",
"vaccine_type": "hpv",
"year": 2023
}9. get_birth_statistics
出生率和出生结果指标。
参数:
indicator:“出生率”、“早产”、“剖宫产”、“低出生体重”state:管辖权year:年份过滤器limit,offset:分页
示例:
{
"method": "get_birth_statistics",
"indicator": "preterm",
"state": "CA",
"year": 2024
}10. get_environmental_health
空气质量测量与健康跟踪。
参数:
pollutant:“pm25”、“臭氧”、“组合”(默认值:“组合”)state:状态筛选器county:县名year:年份过滤器limit,offset:分页
示例:
{
"method": "get_environmental_health",
"pollutant": "pm25",
"county": "Los Angeles",
"year": 2023
}11. get_tobacco_impact
吸烟导致的死亡率、发病率和经济成本。
参数:
impact_type:“死亡率”、“发病率”、“经济成本”state:州缩写year:年份过滤器limit,offset:分页
示例:
{
"method": "get_tobacco_impact",
"impact_type": "economic_cost",
"state": "OH",
"year": 2022
}12. get_oral_vision_health
口腔和视力健康监测。
参数:
health_domain:“口头”、“视觉”(必填)state:州缩写year:年份过滤器limit,offset:分页
示例:
{
"method": "get_oral_vision_health",
"health_domain": "oral",
"state": "FL",
"year": 2023
}______________________________________________________________________
二级方法:政策相关和利基专业(3)
13. get_injury_surveillance
TBI监测——按机制分列的急诊就诊、住院和死亡情况。
参数:
injury_type:“tbi”、“motor_vehicle”、“all”(默认值:“tbi”)state:州缩写mechanism:“跌倒”、“机动车”、“攻击”、“运动”、“所有”year:年份过滤器limit,offset:分页
示例:
{
"method": "get_injury_surveillance",
"injury_type": "tbi",
"mechanism": "fall",
"state": "FL",
"year": 2022
}14. get_tobacco_policy
烟草控制政策跟踪(支持5种政策类型)。
参数:
policy_type:“无烟航空”、“医学考试”、“执照”、“税收”、“电子烟”(必填)state:州缩写venue:“工作场所”、“餐厅”、“酒吧”、“政府”、“学校”、“所有”(仅适用于无烟航空)year:年份过滤器limit,offset:分页
例子:
无烟空气法规:
{
"method": "get_tobacco_policy",
"policy_type": "smokefree_air",
"venue": "restaurant",
"state": "CA"
}烟草税立法:
{
"method": "get_tobacco_policy",
"policy_type": "tax",
"state": "NY",
"year": 2023
}电子烟法规:
{
"method": "get_tobacco_policy",
"policy_type": "ecigarette",
"state": "MA"
}15. get_infectious_disease
传染病监测(肺炎球菌、食源性、水传播)。
参数:
disease:“肺炎球菌”、“食源性”、“水传播”(必填)state:州缩写serotype:肺炎球菌血清型过滤器(例如“19A”、“3”)pathogen:食源性/水性病原体名称(如“沙门氏菌”、“大肠杆菌”)year:年份过滤器limit,offset:分页
例子:
按血清型划分的肺炎球菌病:
{
"method": "get_infectious_disease",
"disease": "pneumococcal",
"serotype": "19A",
"year": 2023
}食源性疾病爆发:
{
"method": "get_infectious_disease",
"disease": "foodborne",
"pathogen": "Salmonella",
"state": "TX"
}______________________________________________________________________
第4阶段方法:关键监测差距(3)
16. get_nndss_surveillance
国家法定传染病监测系统-实时检测50多种疾病的爆发。
参数:
nndss_disease:“虫媒病毒”、“肝炎”、“结核病”、“风疹”、“百日咳”、“嗜血杆菌”、“qfever”、“肉毒中毒”、“所有”(默认值:“所有”)year:年份过滤器(历史结核病数据:2014-2019)state:州缩写limit,offset:分页
例子:
虫媒病毒病监测:
{
"method": "get_nndss_surveillance",
"nndss_disease": "arboviral",
"state": "FL",
"year": "2024"
}结核病历史数据:
{
"method": "get_nndss_surveillance",
"nndss_disease": "tuberculosis",
"year": "2019",
"state": "CA"
}17. get_covid_vaccination
新冠肺炎疫苗接种跟踪与公平指标。
参数:
vax_geography:“国家”、“州”、“县”(默认值:“州”)state:州缩写county:县名equity_metrics:包括SVI和城市/农村分类(布尔值)limit,offset:分页
例子:
州级疫苗接种率:
{
"method": "get_covid_vaccination",
"vax_geography": "state",
"state": "TX"
}县级公平指标:
{
"method": "get_covid_vaccination",
"vax_geography": "county",
"state": "NY",
"county": "New York",
"equity_metrics": true
}18. get_overdose_surveillance
药物过量危机监测与药物特异性跟踪。
参数:
overdose_geography:“国家”、“州”、“县”(默认值:“州”)drug_type:“阿片类药物”、“芬太尼”、“海洛因”、“可卡因”、“甲基苯丙胺”、“所有”(默认值:“所有”)provisional:使用临时数据(true)或最终数据(false)-默认值:truestate:州缩写county:县名limit,offset:分页
例子:
各州芬太尼过量情况:
{
"method": "get_overdose_surveillance",
"overdose_geography": "state",
"drug_type": "fentanyl",
"state": "OH",
"provisional": true
}县级阿片类药物死亡:
{
"method": "get_overdose_surveillance",
"overdose_geography": "county",
"drug_type": "opioid",
"county": "Alameda",
"state": "CA"
}所有过量用药(最终数据):
{
"method": "get_overdose_surveillance",
"overdose_geography": "national",
"drug_type": "all",
"provisional": false
}______________________________________________________________________
常见地点测量ID
慢性病
DIABETES:诊断为糖尿病OBESITY:成人肥胖(BMI≥30)CHD:冠心病COPD:慢性阻塞性肺病ASTHMA:当前哮喘STROKE:中风BPHIGH:高血压CANCER:癌症(不包括癌症)KIDNEY:慢性肾病ARTHRITIS:关节炎
心理健康
DEPRESSION:抑郁症MHLTH:心理健康状况不佳≥14天
预防
DENTAL:年度牙科检查ACCESS2:缺乏医疗保险(65岁以下的成年人)CHECKUP:没有年度检查CHOLSCREEN:胆固醇筛查CERVICAL:宫颈癌症筛查COLON_SCREEN:结直肠癌癌症筛查MAMMOUSE:乳房X线摄影
危险因素
CSMOKING:当前吸烟情况BINGE:酗酒LPA:没有闲暇时间的体育活动SLEEP:睡眠时间\
Click to expand full dataset list
地点(5个数据集):
places_county_2024-2024年县级places_county_2023-2023年县级places_place_2024-2024年城市/镇级places_tract_2024-2024年人口普查区水平places_zcta_2024-邮政编码级别2024
BRFSS(7个数据集):
brfss_comprehensive-2011年至今(30+项措施)brfss_obesity_national-全国肥胖趋势brfss_obesity_state-州肥胖率brfss_diabetes-糖尿病患病率brfss_asthma-哮喘患病率brfss_smart_county-大都市县级brfss_healthcare_access_historical- 1995-2010
青年健康(2个数据集):
yrbss_high_school-青少年风险行为youth_nutrition_activity-青年营养/活动
呼吸系统(2个数据集):
respiratory_combined-呼吸道合胞病毒/新冠肺炎/流感rsv_hospitalizations-呼吸道合胞病毒特异性
疫苗接种(5个数据集):
teen_vaccinations-HPV、Tdap、MenACWYflu_vaccination_coverage-所有年龄6+个月pregnant_vaccinations-妊娠期流感、破伤风三联疫苗kindergarten_vaccinations-入学率
生命统计(5个数据集):
vsrr_birth_quarterly-出生指标birth_rates_age-特定年龄生育率vsrr_quarterly_mortality-死亡率估计vsrr_maternal_mortality-产妇死亡vsrr_infant_mortality-婴儿死亡率
环境(2个数据集):
air_quality_tracking-PM2.5、臭氧water_fluoridation-氟化统计
烟草(6个数据集):
sammec_smoking_impact-经济成本smokefree_air_legislation-无烟法medicaid_cessation_coverage-停播覆盖范围tobacco_licensure-零售商执照tobacco_tax-税收立法ecigarette_legislation-电子烟法规
伤害(2个数据集):
tbi_surveillance-TBI监测alcohol_impaired_driving-酒后驾驶死亡
传染病(2个数据集):
pneumococcal_disease-25年血清型数据foodborne_outbreaks-食源性/水性
母婴(3个数据集):
breastfeeding_nis-母乳喂养率pramstat_2009PRAMS 2009
口腔/视觉(2个数据集):
oral_health_indicators-没有vision_health-BRFSS视觉模块
营养(3个数据集):
nutrition_obesity-行为学nutrition_policy_environmental-政策/环境nutrition_commute_patterns-通勤
特定疾病(4个数据集):
heart_disease_mortality-心脏病diabetes_indicators-糖尿病监测cancer_incidence-癌症统计covid_cases2019冠状病毒疾病
历史(1个数据集):
- 已在BRFSS下列出
NNDSS-国家法定传染病监测(14个数据集):
nndss_arboviral-虫媒病毒性疾病(寨卡病毒、西尼罗河病毒等)nndss_hepatitis-甲型、乙型、丙型病毒性肝炎nndss_tuberculosis-当前结核病监测nndss_rubella-风疹和先天性风疹nndss_pertussis-百日咳监测nndss_haemophilus-流感嗜血杆菌病nndss_qfever-Q热监测nndss_botulism-肉毒杆菌监测nndss_tb_2019-历史TB 2019nndss_tb_2018-历史TB 2018nndss_tb_2017-历史TB 2017nndss_tb_2016-历史TB 2016nndss_tb_2015-历史TB 2015nndss_tb_2014-历史TB 2014
新冠肺炎疫苗接种(4个数据集):
covid_vax_jurisdiction-州/地区疫苗接种率covid_vax_county-县级疫苗接种覆盖率covid_vax_respiratory_weekly-每周呼吸道病毒疫苗接种covid_vax_age_trends-年龄分层疫苗接种趋势
药物过量监测(6个数据集):
overdose_provisional_state-州级临时过量死亡overdose_county-县级药物过量死亡率overdose_by_drug-药物特异性过量死亡overdose_demographics-人口统计学分层过量数据overdose_nowcast-滞后调整后的过量估计nchs_injury_mortality-综合伤害死亡率数据
速率限制
服务器实现了保守的速率限制(请求之间500毫秒):
- 无应用令牌:共享池(可能被限制)
- 带有应用令牌:1000个请求/小时
要提高限额,请在以下网址注册免费应用令牌https://data.cdc.gov/profile/app_tokens
响应格式
所有方法返回结构一致的JSON:
{
"dataset": "places_county_2024",
"count": 58,
"data": [
{
"year": "2022",
"stateabbr": "CA",
"locationname": "Los Angeles County",
"measureid": "DIABETES",
"data_value": "11.2",
"data_value_unit": "%",
"low_confidence_limit": "10.8",
"high_confidence_limit": "11.6"
}
]
}SoQL查询语言
CDC数据集支持Socrata查询语言(SoQL):
通用参数
$select:选择特定字段$where:过滤条件$order:对结果进行排序$limit:最大结果$offset:分页开始
SoQL条款示例
过滤:
stateabbr='CA' AND data_value>15.0
year>=2020 AND year<=2024
measureid IN ('DIABETES', 'OBESITY', 'CHD')排序:
data_value DESC
year ASC, data_value DESC数据源
所有数据均来自美国疾病控制与预防中心的官方来源:
- https://data.cdc.gov
- https://chronicdata.cdc.gov
