MCP Ships

CruiseMapper MCP服务器

MCP（模型上下文协议）服务器，为Telnyx AI助手提供对CruiseMapper数据的实时访问。

特性

• 船期搜索：获取特定游轮的行程
• 船舶详细信息：检索船舶的技术规格和信息
• 基于日期的搜索：查找在特定日期出发的游轮
• 港口时间表：查看哪些船只抵达/离开港口

安装

1. 导航到项目目录：

cd C:\Users\user\cruisemapper-mcp

1. 安装依赖项：

npm install

运行服务器

开发模式（自动重新加载）：

npm run dev

生产模式：

npm start

测试服务器

使用MCP客户端测试MCP服务器：

npx @modelcontextprotocol/cli client stdio "node server.js"

然后尝试以下命令：

• list -显示可用工具
• call search_ship_schedule {"ship_name": "Liberty of the Seas"}
• call get_port_schedule {"port_name": "Miami"}

与Telnyx集成

选项1：云服务器上的主机

1. 部署到云服务（AWS、Google cloud等）
2. 通过HTTPS端点公开
3. 添加到您的Telnyx助手作为MCP服务器URL

选项2：使用ngrok进行测试

1. 安装ngrok：

npm install -g ngrok

1. 运行MCP服务器：

npm start

1. 在另一个终端中，暴露它：

ngrok http 3000

1. 在Telnyx中使用ngrok HTTPS URL

选项3：存储为集成密钥

1. 前往Telnyx门户>集成秘密
2. 使用标识符创建新密钥： cruisemapper_mcp_url
3. 将值设置为MCP服务器URL
4. 助手配置中的参考

可用工具

1.搜索_发货_日程安排

搜索特定船只的时刻表。

参数：

• ship_name （必填）：游轮名称
• year （可选）：搜索年份
• month （可选）：搜索月份

2.获取运费明细

获取有关船只的详细信息。

参数：

• ship_name （必填）：游轮名称

3.搜索_浏览_日期

按日期、目的地或游轮公司查找游轮。

参数：

• departure_date （可选）：YYYY-MM-DD格式
• destination （可选）：类似“加勒比海”的地区
• cruise_line （可选）：游轮名称

4.get_port_schedule

获取港口的到达/出发信息。

参数：

• port_name （必填）：端口名称
• date （可选）：具体日期（YYYY-MM-DD）

环境变量

您可以设置以下配置：

PORT=3000
LOG_LEVEL=info
MAX_RESULTS=20

故障排除

• 连接被拒绝：确保服务器正在运行
• 未找到工具：检查工具名称是否完全匹配
• 未返回数据：CruiseMapper可能更改了其HTML结构

许可证

麻省理工学院