AI大模型接入MCP服务

┌─────────────────┐     ┌──────────────────┐     ┌─────────────────┐
│   用户提问       │────▶│   AI 助手（LLM）  │────▶│  MCP 服务决策    │
│  "查询青岛港      │     │  理解意图，选择    │     │  判断需要调用    │
│   靠泊船舶"      │     │  合适的工具       │     │  哪些工具        │
└─────────────────┘     └──────────────────┘     └─────────────────┘
                                                          │
                                                          ▼
┌─────────────────┐     ┌──────────────────┐     ┌─────────────────┐
│   返回结果       │◀────│   数据组装与展示   │◀────│  船讯网 API      │
│  "青岛港当前有    │     │  AI 整合多接口     │     │  返回原始数据    │
│   45艘靠泊船..." │     │  数据，生成回复   │     │                 │
└─────────────────┘     └──────────────────┘     └─────────────────┘

┌─────────────────────────────────────────────────────────────────────┐
│                     船讯网 MCP 服务能力全景                          │
├──────────────┬──────────────────────────────────────────────────────┤
│   船舶查询    │ 模糊搜索、单船/多船/船队位置、周边船舶、区域船舶      │
│              │ 船舶船籍、船舶档案                                   │
├──────────────┼──────────────────────────────────────────────────────┤
│   港口查询    │ 港口信息、当前靠泊船、当前到锚船、预抵船舶           │
├──────────────┼──────────────────────────────────────────────────────┤
│   历史行为    │ 船舶历史轨迹、船舶搭靠记录                           │
├──────────────┼──────────────────────────────────────────────────────┤
│   挂靠记录    │ 历史挂靠记录、挂靠指定港口、当前挂靠、港口挂靠历史    │
├──────────────┼──────────────────────────────────────────────────────┤
│   航线规划    │ 点到点航线规划、港到港航线规划、ETA 查询             │
├──────────────┼──────────────────────────────────────────────────────┤
│   气象天气    │ 单点海洋气象、海区气象、全球台风、港口潮汐            │
│              │ 新全球气象、历史气象记录                             │
├──────────────┼──────────────────────────────────────────────────────┤
│   海图应用    │ 船位光栅瓦片、港口位置瓦片                           │
├──────────────┼──────────────────────────────────────────────────────┤
│   海事数据    │ 航行警告查询                                         │
├──────────────┼──────────────────────────────────────────────────────┤
│   监控推送    │ 船队管理、实时船位推送、到离港事件、区域监控          │
│              │ 动态 ETA 推送、AIS 信号消失、搭靠事件、航速提醒      │
└──────────────┴──────────────────────────────────────────────────────┘

┌────────────────────────────────────────────────────────────────────┐
│  ⚠️  重要提示                                                       │
│                                                                    │
│  1. API Key 是调用服务的唯一凭证，请勿泄露给第三方                    │
│  2. 正式使用需联系销售开通更多权限                                  │
│  3. 将 Key 发送给对接的销售人员即可
│
│                                                                    │
│  销售商务邮箱：support@shipxy.com | 电话：400-010-8558                  │
└────────────────────────────────────────────────────────────────────┘

{
  "mcpServers": {
    "shipxy": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-shipxy"],
      "env": {
        "SHIPXY_API_KEY": "您的应用Key"
      }
    }
  }
}

{
  "mcpServers": {
    "shipxy": {
      "command": "shipxy-mcp",
      "args": ["--api-key", "您的应用Key"],
      "transport": "stdio"
    }
  }
}

请帮我查询 MMSI 为 413961925 的船舶当前位置

船舶名称：皖鸿远369 (WANHONGYUAN369)
当前位置：纬度 32.192517°，经度 119.628093°
航速：6.2 节
航向：80.8°
目的地：泰州
预计到达时间：2025-03-31 02:09:00
航行状态：航行中

查询青岛港的信息

港口名称：青岛 (Qingdao)
五位码：CNQDG
时区：UTC+8
所属国家：中国

帮我查一下"中远海运天秤座"这艘船现在在哪里，以及它周围10海里内有哪些船

search_ship(keywords="中远海运天秤座") 
  → get_single_ship(mmsi=477172700)
  → get_surrounding_ship(mmsi=477172700)

帮我分析一下上海港现在的船舶态势，包括靠泊的、锚地等待的、以及未来24小时预抵的船舶情况

search_port(keywords="上海")
  → get_berth_ships(port_code="CNSHG")
  → get_anchor_ships(port_code="CNSHG")
  → get_eta_ships(port_code="CNSHG", start_time=now, end_time=now+24h)

帮我追踪 MMSI 477172700 这艘船从上个月离港以来的航行轨迹，
再看看它现在到上海还要多久，沿途天气怎么样

get_single_ship(mmsi=477172700)
  → get_ship_track(mmsi=477172700, start_time=last_month, end_time=now)
  → get_single_eta_precise(mmsi=477172700, port_code="CNSHG")
  → get_weather_by_point(lng=current_lng, lat=current_lat)

我想了解一下"COSCO SHIPPING LIBRA"这艘船的详细档案，
看看它适合运什么货，以及它最近一年去过哪些港口

search_ship(keywords="COSCO SHIPPING LIBRA")
  → search_ship_particular(mmsi=477172700)
  → get_ship_registry(mmsi=477172700)
  → get_portof_call_by_ship(mmsi=477172700, start_time=one_year_ago, end_time=now)

帮我规划一下从青岛到宁波的最优航线，再看看沿途现在的天气怎么样，
有没有台风需要避让

search_port(keywords="青岛") 
  → search_port(keywords="宁波")
  → plan_route_by_port(start_port_code="CNQDG", end_port_code="CNNBO")
  → get_weather_by_point(lng=midpoint_lng, lat=midpoint_lat)
  → get_typhoon()

帮我监控长江口这个区域现在有多少船，有没有航行警告，
然后再查一下 MMSI 413842124 这艘船最近有没有和其他船靠在一起

get_area_ship(region="长江口多边形坐标")
  → get_nav_warning(area="长江口")
  → search_ship_approach(mmsi=413842124, start_time=recent, end_time=now)

帮我查一下宁波港最近7天的船舶作业情况，
看看平均在港时间是多少，未来有哪些大船要来，今天潮汐情况如何

search_port(keywords="宁波")
  → get_portof_call_by_port(port_code="CNNBO", start_time=7days_ago, end_time=now)
  → get_berth_ships(port_code="CNNBO")
  → get_eta_ships(port_code="CNNBO", start_time=now, end_time=now+7days)
  → get_tide_cn(port_code="CNNBO")

帮我查一下 MMSI 477172700 这艘船过去半年去过哪些港口，
有没有在什么奇怪的地方停过，或者和什么可疑的船接触过

get_portof_call_by_ship(mmsi=477172700, start_time=6months_ago, end_time=now)
  → search_ship_approach(mmsi=477172700, start_time=6months_ago, end_time=now)
  → get_ship_track(mmsi=477172700, start_time=specific_period, end_time=now)

我有一艘船现在在东海 (125°E, 28°N) 附近航行，
帮我查一下那里的天气怎么样，周边海区预报如何，
有没有台风，再到上海的潮汐情况

get_weather_by_point(lng=125, lat=28)
  → get_weather(weather_type=1)
  → get_typhoon()
  → get_tide_cn(port_code="CNSHG")

帮我创建一个叫"华东货轮船队"的船队，把 MMSI 413961925、
477172700、412304788 这三艘船加进去，
然后查一下这个船队现在所有船的位置

manage_fleet(action="create", fleet_name="华东货轮船队")
  → manage_fleet(action="add_ships", fleet_id=new_fleet_id, mmsis=[413961925,477172700,412304788])
  → get_fleet_ship(fleet_id=new_fleet_id)

[动作] + [对象] + [条件/范围] + [输出要求]

示例：
✅ "查询青岛港当前靠泊的集装箱船列表"
✅ "帮我规划从宁波到深圳的航线，并查看沿途天气"
✅ "分析一下 MMSI 477172700 近3个月的挂靠记录"

❌ "帮我查一下船" (太模糊)
❌ "天气怎么样" (缺少位置信息)