美国地质调查局水务MCP
](https://smithery.ai/server/@pgiffy/usgs-water-mcp)
概述
该MCP服务器通过三个API提供对美国地质调查局水数据的全面访问：
- 美国地质勘探局水务API -实时水测量（流量、水位计高度、温度等）
- 实时洪水对API的影响 -当前洪水条件和参考点
- API石油天然气公司 -监测位置元数据、机构代码和地质信息
服务器是模块化设计的，具有通过单个入口点统一的独立API处理程序。
项目结构
usgs-water-mcp/
├── main.py # Unified entry point
├── water_data_api.py # USGS Water Services API tools
├── flood_impact_api.py # Real-Time Flood Impacts API tools
├── ogc_api.py # OGC API tools
├── current_water_levels.py # Legacy combined file (deprecated)
├── Dockerfile # Docker configuration
├── pyproject.toml # Project dependencies
└── README.md # This file服务
如果您想要一个使用这些工具的干净web界面，请访问https://aqua-node.onrender.com/landing帮我做一些测试！
样本输出
以下是获取波托马克河流量数据的示例：
{
"name": "USGS:01646500:00060:00000",
"sourceInfo": {
"siteName": "POTOMAC RIVER NEAR WASHINGTON, DC",
"siteCode": [
{
"value": "01646500",
"network": "NWIS",
"agencyCode": "USGS"
}
]
},
"variable": {
"variableCode": [
{
"value": "00060",
"network": "NWIS",
"vocabulary": "NWIS:UnitValues",
"variableName": "Streamflow, ft�/s",
"variableDescription": "Discharge, cubic feet per second"
}
]
},
"values": [
{
"value": [
{
"value": "6420",
"qualifiers": ["A"],
"dateTime": "2023-10-01T12:00:00.000"
}
]
}
]
}安装
通过pip安装
pip install -e .手动安装
- 克隆此存储库
- 安装依赖项：
pip install httpx mcp与Claude Desktop连接
- 编辑您的Claude Desktop配置文件：
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json - 视窗: %APPDATA%/Claude/claude_desktop_config.json
- 添加服务器配置：
{
"mcpServers": {
"usgs-water": {
"command": "python",
"args": ["/path/to/usgs-water-mcp/main.py"]
}
}
}- 重新启动克劳德桌面
可用工具
水数据工具
fetch_usgs_data
从美国地质调查局监测站获取即时水数据。
参数：
sites（必填）：逗号分隔的站点编号（例如，“01646500”或“0164650001647000”）parameter_codes（可选）：逗号分隔的参数代码（例如“0006000065”）start_date（可选）：ISO格式的开始日期（YYYY-MM-DD或YYYY-MM-MDHH:MM）end_date（可选）：ISO格式的结束日期period（可选）：周期代码（例如，“P7D”表示7天）
常用参数代码：
00060：排放量（溪流流量）00065：仪表高度00010：温度、水00300：溶解氧00400：pH值
示例用法：
Get current stream flow for the Potomac River near Washington, DC:
sites: "01646500"
parameter_codes: "00060"实时洪水影响工具
get_flooding_reference_points
获取当前洪水参考点（每30分钟更新一次）。
获取参考点
获取参考点的分页列表。
参数：
page（可选）：页码（默认：1）limit（可选）：每页结果数（默认值：100）
get_reference_point_by_id
通过ID获取特定参考点。
参数：
reference_point_id（必填）：参考点ID
get_reference_points_by_state
获取特定州的参考点。
参数：
state_id（必填）：州ID（例如“CA”、“TX”）
get_reference_point_by_nwis_id
通过USGS量规ID获取参考点。
参数：
nwis_id（必填）：美国地质调查局国家水信息系统站点ID
get_reference_points_by_nws_id
通过国家气象局ID获取参考点。
参数：
nws_id（必填）：国家气象局位置ID
get_active_reference_points
获取非活动参考点。
get_states
获取州列表。
get_state_by_id
获取具体的州信息。
参数：
state_id（必填）：州ID（例如“CA”、“TX”）
get_解开
获取县列表。
get_countes_by_state
为特定州获取县。
参数：
state_id（必填）：州ID（例如“CA”、“TX”）
get_nws_usgs_人行横道
获取NWS/USGS人行横道数据。
API工具
get_monitor_locations
使用广泛的过滤选项获取监控位置。
参数：
bbox（可选）：将框边界设置为“minx，miny，maxx，maxy”limit（可选）：最大结果数（默认值：100）offset（可选）：分页的起始偏移量（默认值：0）agency_code（可选）：按机构代码过滤（例如“USGS”）state_code（可选）：按州代码过滤（例如“CA”）county_code（可选）：按县代码筛选site_type_code（可选）：按站点类型代码筛选monitoring_location_number（可选）：特定监测位置编号
get_monitor_location_by_id
通过ID获取特定的监控位置。
参数：
location_id（必填）：监控位置ID
get_agency_codes
获取机构识别码。
参数：
limit（可选）：最大结果数（默认值：100）offset（可选）：分页的起始偏移量（默认值：0）
获取高度基准
获取垂直基准信息（推荐：NAVD88）。
参数：
limit（可选）：最大结果数（默认值：100）offset（可选）：分页的起始偏移量（默认值：0）
get_quifer_codes
获取含水层识别信息。
参数：
limit（可选）：最大结果数（默认值：100）offset（可选）：分页的起始偏移量（默认值：0）
get_quifer_types
获取含水层类型信息（承压与非承压）。
参数：
limit（可选）：最大结果数（默认值：100）offset（可选）：分页的起始偏移量（默认值：0）
获取坐标_准确码
获取经纬度值的坐标精度代码。
参数：
limit（可选）：最大结果数（默认值：100）offset（可选）：分页的起始偏移量（默认值：0）
故障排除
常见问题
- API连接错误：确保您有活跃的互联网连接，并且可以访问USGS API
- 站点编号无效：使用美国地质调查局国家水资源数据网站验证站点编号是否存在
- 无可用数据：某些站点可能没有所请求的时间段或参数的数据
- 速率限制：美国地质勘探局API有使用限制；避免快速连续地提出太多请求
查找站点编号
使用 美国地质调查局全国水资源数据 网站，查找您感兴趣的地区的监测站站点编号。