海洋数据MCP服务文档

⚙️ MCP配置

Claude Desktop / Cursor 等客户端配置

在 MCP 配置文件中添加以下配置，YOUR_API_KEY 替换为你的实际 API Key：

{
  "mcpServers": {
    "kts_sst_server": {
      "type": "streamableHttp",
      "url": "https://www.shikongxun.com/kts_sst_server/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

说明： headers 中的 Authorization 会随每次请求自动发送，服务端通过上游 shikongxun.com 远程校验 Key 有效性，校验失败返回 401 Unauthorized。

API Key 申请

请访问 时空寻平台 申请 API Key。

---

🛠️ 可用工具

1. history_sst

功能： 海温监测数据查询

参数：

• lon - 经度（number）
• lat - 纬度（number）
• start_time - 开始时间（datetime）
• end_time - 结束时间（datetime）

限制： 时间跨度 <=30天

返回示例：

[
  {"time": "2025-06-01T00:00:00", "value": 28.5},
  {"time": "2025-06-02T00:00:00", "value": 28.7}
]

返回字段说明：

字段	类型	说明
time	string	观测时间（ISO 8601 格式）
value	number	海温值（℃）

---

2. sst_forecast

功能： 海温预测（自动预测未来10天）

参数：

• lon - 经度（number）
• lat - 纬度（number）

返回示例：

[
  {"time": "2025-07-30T00:00:00", "value": 29.2},
  {"time": "2025-07-31T00:00:00", "value": 29.5}
]

返回字段说明：

字段	类型	说明
time	string	预报时间（ISO 8601 格式）
value	number	海温预测值（℃）

---

3. chlorophyll_query

功能： 叶绿素浓度查询与等级判识

参数：

• lon - 经度（number）
• lat - 纬度（number）
• start_time - 开始时间（datetime）
• end_time - 结束时间（datetime）

限制： 时间跨度 <=30天

返回示例：

[
  {
    "time": "2025-06-01T00:00:00",
    "value": {
      "trophic": "中营养 ~ 富营养",
      "description": "大部分近岸海域、水库、河流、城市湖泊。初级生产力较高，是常见状态。"
    }
  }
]

返回字段说明：

字段	类型	说明
time	string	观测时间（ISO 8601 格式）
value.trophic	string	营养等级（超贫营养 / 贫营养~中营养 / 中营养~富营养 / 富营养~超富营养）
value.description	string	营养等级描述

---

4. chlorophyll_forecast

功能： 叶绿素预测（自动预测未来2天）

参数：

• lon - 经度（number）
• lat - 纬度（number）

返回示例：

[
  {
    "time": "2025-07-30T00:00:00",
    "value": {
      "trophic": "中营养 ~ 富营养",
      "description": "大部分近岸海域、水库、河流、城市湖泊。"
    }
  }
]

返回字段说明：

字段	类型	说明
time	string	预报时间（ISO 8601 格式）
value.trophic	string	营养等级
value.description	string	营养等级描述

---

5. transparency_query

功能： 水体透明度查询(Kd490)

参数：

• lon - 经度（number）
• lat - 纬度（number）
• start_time - 开始时间（datetime）
• end_time - 结束时间（datetime）

限制： 时间跨度 <=30天

返回示例：

[
  {
    "time": "2025-06-01T00:00:00",
    "value": {
      "kd490": 0.15,
      "level": "中等透明度",
      "secchi_depth": 11.33
    }
  }
]

返回字段说明：

字段	类型	说明
time	string	观测时间（ISO 8601 格式）
value.kd490	number	490nm漫衰减系数（m⁻¹），值越小水体越透明
value.level	string	透明度等级（极高透明度 / 高透明度 / 中等透明度 / 低透明度 / 极低透明度）
value.secchi_depth	number	塞克盘深度估算值（m）

---

6. transparency_forecast

功能： 水体透明度预测（自动预测未来2天）

参数：

• lon - 经度（number）
• lat - 纬度（number）

返回示例：

[
  {
    "time": "2025-07-30T00:00:00",
    "value": {
      "kd490": 0.12,
      "level": "中等透明度",
      "secchi_depth": 14.17
    }
  }
]

返回字段说明：

字段	类型	说明
time	string	预报时间（ISO 8601 格式）
value.kd490	number	490nm漫衰减系数（m⁻¹）
value.level	string	透明度等级
value.secchi_depth	number	塞克盘深度估算值（m）

---

📍 常见位置

• 珠海：113.6, 22.3
• 深圳：114.1, 22.5
• 广州：113.3, 23.1
• 香港：114.2, 22.3
• 澳门：113.5, 22.2

---

⚠️ 常见错误

错误信息	原因	解决方案
Missing API key	未携带 API Key	在配置中添加 headers: {"Authorization": "Bearer YOUR_API_KEY"}
API key validation failed	API Key 无效或已过期	检查 Key 是否正确，或重新申请
时间跨度不能超过 30天	监测数据查询超过 30 天	缩短时间范围至 30 天以内
有效海温数据不足，无法进行分析	该时段无监测数据	确认时间范围在数据覆盖期内
有效海温预测数据不足	该时段无预测数据	稍后重试