使用说明
政府数据MCP
MCP服务器+TypeScript SDK，用于114个政府数据API
562种工具，涵盖联邦、州和国际政府数据——经济、财政、卫生、教育、能源、环境、立法、金融、运输、过境、交通、安全、采购、科学、贸易、判例法、竞选资金等。所有50个州+DC都有代表。
40+API不需要密钥 ·其余的使用免费密钥，需要不到一分钟的时间才能获得· 完整的工具参考
特性
- 562工具 跨越114个政府数据模块——联邦机构、州门户网站、交通系统、能源网和国际资源
- 所有50个州+DC --47个州的通用Socrata+AArcGIS工具、15个州的实时511流量、12个交通系统和各州特定的API
- 交叉引用 --内置路由表引导LLM自动组合来自多个机构的数据
- 代码模式 --WASM沙盒JavaScript执行可将大型响应的上下文窗口使用率降低98-100%
- 选择性加载 --只加载您需要的内容：
--modules fred,treasury,state-data,mbta - 双重运输 --stdio用于桌面客户端，HTTP流用于网络/远程
- TypeScript SDK -每个API都可以作为独立类型的客户端导入，不需要MCP
- 磁盘备份缓存 --响应缓存到磁盘，在重新启动后仍然有效
- 速率限制+重试 --429/503上的指数退避令牌桶速率限制器
快速开始
MCP服务器
npx gov-data-mcp
添加到克劳德桌面(claude_desktop_config.json):
{
"mcpServers": {
"gov-data": {
"command": "npx",
"args": ["-y", "gov-data-mcp"],
"env": {
"FRED_API_KEY": "your_key",
"DATA_GOV_API_KEY": "your_key"
}
}
}
}
添加到VS代码/副本(.vscode/mcp.json):
{
"servers": {
"gov-data": {
"command": "npx",
"args": ["-y", "gov-data-mcp"],
"env": {
"FRED_API_KEY": "your_key",
"DATA_GOV_API_KEY": "your_key"
}
}
}
}
仅加载特定模块
# Federal economic data only
npx gov-data-mcp --modules fred,treasury,bls,bea,eia
# State data only
npx gov-data-mcp --modules state-data,state-511,md-traffic,mbta,bart
# Everything (default)
npx gov-data-mcp
HTTP流（用于远程/web客户端）
npx gov-data-mcp --transport httpStream --port 8080
示例提示
经济： “美国目前的经济状况如何？给我看看国内生产总值、失业率、通货膨胀率和利率。”
健康： “向我展示Ozempic的不良事件概况，包括临床试验、FDA报告和向医生支付的药品费用。”
立法的： “《通胀削减法案》发生了什么？谁发起了这项法案，各党派的投票结果如何？”
状态数据： “比较马里兰州和弗吉尼亚州过去10年的犯罪率。”
过境： “波士顿目前的MBTA延误是什么？有任何服务警报吗？”
交通： “给我看看俄亥俄州高速公路上当前的交通事故。”
能源： “德克萨斯州ERCOT电网目前的燃料组合是什么？风能和天然气的比例是多少？”
环境： “加利福尼亚州目前的水库水位是多少？有任何干旱问题吗？”
交叉引用： “在过去的5年里，联邦医疗保健支出发生了怎样的变化，它产生了什么健康结果？”
TypeScript SDK
npm install gov-data-mcp
import { getObservations } from "gov-data-mcp/sdk/fred";
import { searchBills } from "gov-data-mcp/sdk/congress";
import { queryStateDataset } from "gov-data-mcp/sdk/state-data";
const gdp = await getObservations("GDP", { sort: "desc", limit: 5 });
const mdCrime = await queryStateDataset("MD", "jwfa-fdxs", { where: "year = '2023'" });
不需要MCP服务器。所有功能都包括缓存、重试和速率限制。
数据源（114个模块，562个工具）
看 TOOLS.md 用于完整的工具参考，包括参数和描述。
联邦-经济（12个模块）
| 模块 | 工具 | 身份验证 | 数据 |
|---|---|---|---|
treasury |
4 | -- | 财政数据、债务、利率 |
fred |
4 | 关键 | 美联储经济时间序列 |
bls |
4 | 关键 | 就业、CPI、劳动力统计 |
bea |
13 | 关键 | GDP、个人收入、贸易、I/O表 |
eia |
5 | 关键 | 能源生产、消费、价格 |
census |
3 | 关键 | 人口、人口统计、ACS数据 |
dol |
7 | 关键 | OSHA检查、工资执行、UI索赔 |
usajobs |
2 | 关键 | 联邦工作列表 |
fcc |
2 | -- | 宽带覆盖范围和提供商 |
uspto |
10 | 关键 | 专利、申请、PTAB决定 |
sbir |
1 | -- | 小企业创新研究奖 |
gsa-calc |
3 | -- | GSA合同最高费率 |
联邦-健康（8个模块）
| 模块 | 工具 | 身份验证 | 数据 |
|---|---|---|---|
fda |
25 | 关键 | 药物、设备、食品、烟草（OpenFDA） |
cdc |
13 | -- | 死亡率、疾病、新冠肺炎、肥胖、地点 |
clinical-trials |
10 | -- | ClinicalTrials.gov研究 |
cms |
4 | -- | 医院/疗养院质量，医疗保险 |
open-payments |
10 | -- | 制药公司向医生支付的费用（阳光法案） |
pubmed |
8 | 关键词 | 生物医学文献检索 |
nih |
4 | -- | 美国国立卫生研究院的研究项目和资金 |
va |
1 | 关键 | VA设施（医院、诊所、墓地） |
联邦-立法（6个模块）
| 模块 | 工具 | 身份验证 | 数据 |
|---|---|---|---|
congress |
71 | 关键 | 法案、投票、成员、委员会、CRS报告 |
federal-register |
5 | -- | 规则、行政命令、总统文件 |
govinfo |
3 | 关键 | 国会记录，国会预算办公室报告 |
regulations |
6 | 关键 | Regulations.gov摘要和评论 |
senate-lobbying |
5 | -- | 游说披露、注册人 |
ecfr |
3 | -- | 联邦法规全文 |
联邦-金融（7个模块）
| 模块 | 工具 | 身份验证 | 数据 |
|---|---|---|---|
fec |
6 | 关键 | 竞选资金、候选人、委员会 |
sec |
3 | -- | EDGAR公司文件和财务状况 |
fdic |
6 | -- | 银行数据、破产、财务 |
cfpb |
6 | -- | 消费者投诉 |
cfpb-hmda |
6 | -- | 住房抵押贷款披露数据 |
cftc |
5 | -- | 期货交易头寸 |
ofac |
5 | -- | 制裁和受阻人员 |
联邦-支出和采购（3个模块）
| 模块 | 工具 | 身份验证 | 数据 |
|---|---|---|---|
usaspending |
6 | -- | 联邦奖项、获奖者、机构预算 |
sam-gov |
3 | 关键 | 合同机会、实体、除外责任 |
gsa-calc |
3 | -- | GSA合同最高费率 |
联邦-环境与科学（16个模块）
| 模块 | 工具 | 身份验证 | 数据 |
|---|---|---|---|
epa |
9 | -- | 设施、执法、超级基金、TRI、GHG |
epa-aqs |
3 | 重点 | 空气质量监测站 |
noaa |
4 | 关键 | 气候数据、气象站、天气历史 |
noaa-coops |
10 | -- | 潮汐、洋流、水位 |
noaa-swpc |
12 | -- | 太空天气、太阳风暴 |
nws |
15 | -- | 预报、警报、雷达 |
usgs |
6 | -- | 地震、水文数据、流量表 |
nrel |
3 | 关键 | 太阳能、加油站、公用事业费率 |
fws |
2 | -- | 濒危物种名录 |
nps |
4 | 关键 | 国家公园、警报、露营地 |
recreation |
3 | 关键 | 联邦娱乐设施、露营地 |
usace-cwms |
3 | -- | 兵团大坝/水库/河流水位 |
nasa-images |
2 | -- | NASA图像库 |
nasa-science |
5 | 关键 | 近地天体、DONKI、火星漫游者、EONET |
jpl |
3 | -- | 小行星轨道、近距离接近、火球 |
nsf |
2 | -- | 研究奖项和资助 |
联邦-安全（5个模块）
| 模块 | 工具 | 身份验证 | 数据 |
|---|---|---|---|
nhtsa |
11 | -- | 车辆召回、投诉、安全评级 |
fema |
5 | -- | 灾害申报、援助 |
cpsc |
4 | -- | 产品安全召回 |
ftc |
2 | 关键 | 联邦贸易委员会的执法行动 |
nvd |
2 | 关键 | CVE漏洞，CVSS评分 |
联邦-其他（9个模块）
| 模块 | 工具 | 身份验证 | 数据 |
|---|---|---|---|
ntsb |
2 | -- | 交通事故调查 |
bts |
2 | -- | 过境点、运输统计 |
faa-weather |
4 | -- | METAR、TAF、SIGMET、PIREP |
smithsonian |
2 | 关键 | 1100多万博物馆收藏记录 |
doe-osti |
1 | -- | DOE科学出版物 |
naep |
9 | -- | 国家成绩单教育成绩 |
college-scorecard |
4 | 关键 | 大学费用、成果、收入 |
usda-fooddata |
3 | 关键 | 食品营养数据 |
usda-nass |
4 | 关键 | 农业统计 |
world-bank |
4 | -- | 国际发展指标 |
州和地方——开放数据（1个模块，30个州）
| 模块 | 工具 | 覆盖范围 |
|---|---|---|
state-data |
15 | 所有50个州+DC通过Socrata SODA API+ArcGIS REST。犯罪、健康、教育、经济、财产、环境、交通。MD完全填充（21个数据集），NY（13个），CT（12个），WA（8个），TX（7个），PA（7），NJ（4个），还有40多个使用GIS和/或Socrata门户网站。 |
州和地方——实时流量（2个模块，15+个州）
| 模块 | 工具 | 覆盖范围 |
|---|---|---|
state-511 |
6 | 15个州：亚利桑那州、内华达州、犹他州、阿拉斯加州、印第安纳州、纽约州、康涅狄格州、佐治亚州、威斯康星州、洛杉矶、阿肯色州、俄亥俄州、北卡罗来纳州、华盛顿州。事件、摄像头、标志、天气、条件。 |
md-traffic |
7 | 马里兰图表：事件、关闭、摄像头、速度、天气、DMS、旅行时间 |
州和地方-交通（12个模块）
| 模块 | 工具 | 身份验证 | 城市/地区 |
|---|---|---|---|
mbta |
4 | Key | 波士顿（地铁、公共汽车、通勤铁路、渡轮） |
septa |
4 | -- | 费城（区域铁路、公共汽车、无轨电车） |
cta |
2 | Key | 芝加哥（L列车、公共汽车） |
bart |
3 | 关键 | 旧金山湾区（BART铁路） |
la-metro |
3 | -- | 洛杉矶（公共汽车、火车） |
trimet |
1 | Key | 波特兰（公共汽车、MAX轻轨、有轨电车） |
onebusaway |
2 | Key | 西雅图/普吉特海湾（公共汽车、轻轨） |
wsdot-ferries |
3 | Key | 华盛顿州渡轮（时刻表、船只、码头） |
marta |
1 | Key | 亚特兰大（铁路） |
path-train |
1 | -- | 纽约/新泽西州PATH列车 |
wmata |
4 | Key | 华盛顿特区地铁和公共汽车 |
md-transit |
3 | Key | 马里兰州MTA（公共汽车、轻轨、地铁、MARC） |
州和地方——电网（3个模块）
| 模块 | 工具 | 身份验证 | 覆盖率 |
|---|---|---|---|
caiso |
1 | 令牌 | 加州ISO（费率、温室气体、灵活警报） |
ercot |
2 | 关键 | 德克萨斯州电网（负荷、价格） |
iso-ne |
2 | 作者 | 新英格兰（CT、MA、ME、NH、RI、VT） |
州和地方-水与环境（5个模块）
| 模块 | 工具 | 身份验证 | 数据 |
|---|---|---|---|
cdec |
2 | -- | 加利福尼亚州的水库、河流、积雪 |
calfire |
1 | -- | 活跃的加州野火事件（GeoJSON） |
co-water |
3 | 关键 | 科罗拉多州水权、河流流量、改道 |
md-bay |
3 | 关键 | 切萨皮克湾浮标水质（CBIBS） |
mn-lakes |
3 | -- | 明尼苏达州4500多个湖泊、鱼类调查 |
州和地方-其他（1个模块）
| 模块 | 工具 | 身份验证 | 数据 |
|---|---|---|---|
nc-linc |
2 | -- | NC 900+人口/经济数据项 |
API密钥
大多数工具在没有任何API密钥的情况下工作。对于那些需要钥匙的人来说，钥匙是免费的：
| 密钥 | 使用人 | 获取 |
|---|---|---|
DATA_GOV_API_KEY |
美国食品药品监督管理局、国会、联邦调查局、联邦选举委员会、政府信息、法规、NREL、大学记分卡、美国农业部食品数据、联邦贸易委员会 | api.data.gov/注册 |
FRED_API_KEY |
弗雷德 | fredaccount.stlouisfed.org/apikeys |
SOCRATA_APP_TOKEN |
州开放数据（所有索克拉塔州） | 在任何州门户网站上注册 |
CENSUS_API_KEY |
人口普查 | api.census.gov/data/key_signup.html |
BEA_API_KEY |
BEA | apps.bea.gov/API/注册 |
NASA_API_KEY |
美国国家航空航天局科学 | api.nasa.gov （DEMO_KEY无需注册即可使用） |
NPS_API_KEY |
国家公园管理局 | nps.gov/主题/开发者 |
查看完整列表 npx gov-data-mcp --list-modules.
免责声明
该项目集成了大量政府API，其中许多API具有大型、复杂或文档不一致的模式。在整个项目中，人工智能被用作一种工具，以帮助解析API文档、生成类型定义和脚手架工具实现，从而有可能覆盖如此多的表面区域，并使人们能够比其他情况下更快地访问政府数据。虽然已尽一切努力确保准确性，但一些端点可能会返回意外结果、参数覆盖不完整或行为与记录不同。
这是一项由社区推动的努力——如果你发现有什么问题或可以改进的地方，请打开一个问题或提交一份PR。目标是让政府数据尽可能地可访问和可靠。
所有数据均来自美国政府、州和国际官方API，服务器不会生成、修改或编辑任何数据。
许可证
麻省理工学院
