马士基船舶截止日期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=", "dipankan001/maersk-mcp:v1"]
}
}
}其他MCP客户端
对于其他MCP兼容客户端,请使用中指定的适当连接方法(HTTP、stdio等)配置服务器 MCP规范.
端点
该应用程序公开了MCP工具,用于:
- 获取船舶国际海事组织编号
- 获取船舶时间表和装运截止日期
- 扣押活跃的港口停靠船只
看 main.py 有关可用工具及其参数的详细信息。
资源
-
