Shiplogic MCP Server
2025.05.12
0
JavaScript航运服务物流管理金融服务
Shiplogic MCP Server 是一个基于 Model Context Protocol (MCP) 的服务，专门用于与 Shiplogic 航运 API 进行无缝集成。该服务使用 TypeScript 构建，提供类型安全和更好的开发者体验。主要功能包括获取运费、创建货运、实时跟踪包裹、取消货运等。适用于需要集成航运服务的应用场景。
View on GitHub
Overview
基本能力
产品定位
Shiplogic MCP Server 是一个专门用于与 Shiplogic 航运 API 集成的 MCP 服务，提供航运相关的各种功能。
核心功能
- 🚚 获取运费 - 计算两个地址之间的运费
- 📦 创建货运 - 预订货运并自动生成跟踪号
- 🔍 跟踪包裹 - 实时跟踪货运状态
- ❌ 取消货运 - 在需要时取消预订
- ➕ 可选服务 - 获取特殊服务的附加费率
- 📚 地址簿管理 - 存储和管理常用地址
适用场景
- 电子商务平台的运费计算
- 物流管理系统的货运预订和跟踪
- 需要集成航运服务的应用
工具列表
- get_shipping_rates - 计算两个地址之间的运费
- create_shipment - 创建新的货运并生成跟踪号
- track_shipment - 通过参考号跟踪货运
- cancel_shipment - 取消现有的货运
- get_opt_in_rates - 获取可选附加服务的费率
- add_address_to_book - 将地址添加到地址簿
- get_address_book - 从地址簿中检索地址
- remove_address_from_book - 从地址簿中删除地址
常见问题解答
- 如何获取 Shiplogic API 密钥？ 访问 shiplogic.com 获取 API 密钥。
- 如何测试服务器？
使用
npm run inspect命令运行 MCP Inspector 进行测试。
使用教程
使用依赖
- Node.js 18+
- npm 或 yarn
- Shiplogic API 密钥
安装 Node.js 和 npm 的命令（以 Ubuntu 为例）：
sudo apt update
sudo apt install nodejs npm
安装教程
- 克隆并安装：
git clone https://github.com/jlwainwright/shiplogic-mcp.git
cd shiplogic-mcp
npm install
- 配置环境：
cp .env.example .env
# 编辑 .env 文件并添加 Shiplogic API 密钥
- 构建服务器：
npm run build
调试方式
- 使用 MCP Inspector 测试服务器：
npm run inspect
- 直接运行服务器：
npm run dev
- 测试工具列表：
curl -X POST http://localhost:3000/tools/list