船舶信息查询服务

一个基于Model Context Protocol (MCP)的服务器,提供马士基船舶信息、船舶时间表和装运截止日期的程序化访问。

  • by idipankan
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 idipankan/maersk-mcp

使用说明

马士基船舶截止日期MCP服务器

这个项目是 模型上下文协议(MCP)服务器 该平台提供对马士基船舶信息的程序化访问,包括船舶时刻表和装运截止日期。它公开了MCP兼容客户端(如Claude Desktop、GPT或其他AI助手)可以使用的工具,以从马士基的公共API中检索最新的航运数据。

关于模型上下文协议(MCP)

这 模型上下文协议 是一个开放标准,使人工智能助手能够连接到外部数据源和工具。MCP服务器为AI模型提供了一种标准化的方式,通过安全、结构化的界面访问实时信息并执行操作。

功能和可用工具

MCP服务器公开了以下工具:

1. get_vessel_imo

  • 说明: 按船舶名称检索船舶的IMO(国际海事组织)编号。
  • 输入: 船舶名称(字符串)
  • 输出: IMO编号(字符串)

2. get_vessel_schedule

  • 说明: 根据船舶的IMO编号、航次编号、装货港和ISO国家代码,检索船舶的时间表和装运截止日期。
  • 输入:
    • vessel_imo:船舶的国际海事组织编号(字符串)
    • voyage_number:航次号(字符串)
    • port_of_loading:装货港(字符串)
    • iso_country_code:港口的ISO国家代码(字符串)
  • 输出: 船舶时间表和截止日期的可读摘要

3. get_port_calls

  • 说明: 根据下一周的国家和装货港,检索停靠特定港口的船只。
  • 输入:
    • country_code:ISO国家代码
    • city_name:POL城市名称
  • 输出: 未来一周停靠港口的船只的可读摘要。

这些工具在 main.py 并且可以通过MCP协议访问,以与AI助手和其他MCP客户端集成。

需求

  • Python 3.11+
  • 马士基API消费者密钥(设置为 CONSUMER_KEY 在您的环境中)

安装与使用

使用Docker(推荐)

预构建的Docker镜像可在以下网址获得 dipankan001/maersk-mcp:v1:

docker pull dipankan001/maersk-mcp:v1
docker run -e CONSUMER_KEY=INSERT_API_KEY_HERE dipankan001/maersk-mcp:v1

连接到MCP客户端

克劳德桌面

将此添加到您的Claude Desktop配置中:

{
  "mcpServers": {
    "maersk-mcp-server": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "-e", "CONSUMER_KEY=<INSERT_API_KEY_HERE>", "dipankan001/maersk-mcp:v1"]
    }
  }
}

其他MCP客户端

对于其他MCP兼容客户端,请使用中指定的适当连接方法(HTTP、stdio等)配置服务器 MCP规范.

端点

该应用程序公开了MCP工具,用于:

  • 获取船舶国际海事组织编号
  • 获取船舶时间表和装运截止日期
  • 扣押活跃的港口停靠船只

看 main.py 有关可用工具及其参数的详细信息。

资源