PolarHub
  • Agents
  • MCP Servers
  • Skills
  • PolarBear
PolarHub © 2026
MCP Serversecommerce-and-retailjlwainwright
返回「ecommerce-and-retail」

jlwainwright

modelscope·@jlwainwright/shiplogic-mcp

ecommerce-and-retail0下载LocalModelScope

简介

暂无描述。

MCP Server 详情

来自 ModelScope 索引

Shiplogic MCP 服务器

请我喝咖啡

这是一个模型上下文协议(MCP)服务器,提供与Shiplogic运输API的无缝集成。使用MCP SDK和TypeScript构建,以确保类型安全并提升开发体验。

演示

bash

与Claude的示例对话:

用户: "查询从开普敦到约翰内斯堡2.5公斤包裹的运费" Claude: "我将为您查询运费..."

[使用工具: get_shipping_rates] 结果: 经济服务 - R95 (2-3天送达)

用户: "预订经济服务" Claude: "正在创建发货单..."

[使用工具: create_shipment] 结果: 发货单已创建!追踪号: QR4FVL

功能

  • 🚚 获取运费 - 计算两地之间的运输成本
  • 📦 创建发货单 - 预订发货单并自动跟踪
  • 🔍 追踪包裹 - 实时追踪发货状态
  • ❌ 取消发货单 - 在需要时取消预订
  • ➕ 可选服务 - 获取特殊服务的附加费率
  • 📚 地址簿管理 - 存储和管理常用地址

安装

前提条件

  • Node.js 18+
  • npm 或 yarn
  • Shiplogic API 密钥(在 shiplogic.com 获取)

快速开始

  1. 克隆并安装: bash git clone https://github.com/jlwainwright/shiplogic-mcp.git cd shiplogic-mcp npm install

  2. 配置环境变量: bash cp .env.example .env

    编辑 .env 并添加您的 Shiplogic API 密钥

  3. 构建服务器: bash npm run build

使用方法

与Claude桌面版配合使用

将以下内容添加到您的Claude桌面配置中:

json { "mcpServers": { "shiplogic": { "command": "node", "args": ["/absolute/path/to/shiplogic-mcp/dist/index.js"], "env": { "SHIPLOGIC_API_KEY": "your_api_key_here" } } } }

通过MCP Inspector测试

使用MCP Inspector测试服务器:

bash npm run inspect

独立运行

直接运行服务器:

bash npm run dev

可用工具

get_shipping_rates

计算两个地址之间的运费。

typescript { collection_address: { street_address: string, city: string, code: string, country?: string, type?: "residential" | "business" }, delivery_address: { street_address: string, city: string, code: string, country?: string, type?: "residential" | "business" }, parcels: [{ length: number, // cm width: number, // cm height: number, // cm weight: number, // kg description?: string }], declared_value?: number }

create_shipment

创建带有跟踪的新发货单。

typescript { service_level_code: string, // 例如:"ECO" collection_address: { /* 同上 / }, delivery_address: { / 同上 / }, parcels: [{ / 同上 */ }], collection_contact: { name: string, mobile_number?: string, email?: string }, delivery_contact: { name: string, mobile_number?: string, email?: string }, customer_reference?: string, mute_notifications?: boolean }

track_shipment

通过参考编号追踪发货单。

typescript { tracking_number: string }

cancel_shipment

取消现有的发货单。

typescript { tracking_reference: string }

get_opt_in_rates

获取可选附加服务的费率。

typescript { collection_address: { /* 地址对象 / }, delivery_address: { / 地址对象 */ } }

add_address_to_book

向账户地址簿中添加一个地址。

typescript { account_id: number, address: { street_address: string, city: string, code: string, country?: string, type?: "residential" | "business", company?: string }, name?: string, // 此地址条目的名称 type?: "collection" | "delivery" // 地址类型 }### get_address_book

从账户的地址簿中检索地址。

typescript { account_id: number, type?: "collection" | "delivery" // 可选,按类型过滤 }

remove_address_from_book

从账户的地址簿中移除一个地址。

typescript { account_id: number, address_id: number }

配置

环境变量:

变量描述是否必需默认值
SHIPLOGIC_API_KEY您的Shiplogic API密钥是-
SHIPLOGIC_API_URLAPI基础URL否https://api.shiplogic.com

开发

项目结构

shiplogic-mcp-official/ ├── src/ │ └── index.ts # 主服务器实现 ├── dist/ # 编译后的JavaScript(生成) ├── package.json ├── tsconfig.json ├── .env.example └── README.md

脚本

  • npm run build - 编译TypeScript
  • npm run dev - 构建并运行
  • npm run inspect - 使用MCP Inspector运行

测试

bash

使用MCP Inspector运行

npm run inspect

在另一个终端中测试工具

curl -X POST http://localhost:3000/tools/list

API参考

此服务器与Shiplogic API v2集成。有关详细的API文档,请参阅:

  • Shiplogic API文档
  • MCP协议规范

许可证

MIT许可证 - 查看LICENSE文件

贡献

  1. 分叉仓库
  2. 创建您的功能分支 (git checkout -b feature/amazing-feature)
  3. 提交更改 (git commit -m 'Add amazing feature')
  4. 推送到分支 (git push origin feature/amazing-feature)
  5. 打开Pull Request

支持

  • 🐛 问题:GitHub Issues
  • 📧 电子邮件:your.email@example.com
  • 📚 文档:Wiki
  • ☕ 支持我的工作:Buy Me a Coffee

如果您觉得这个项目有帮助,请考虑支持我的工作。您的支持有助于我投入更多时间进行开源开发,并为社区创造更好的工具。

致谢

  • 使用Model Context Protocol SDK构建
  • 由Shiplogic API提供支持

由Jacques Wainwright用❤️制作

相关 MCP Servers(来自「ecommerce-and-retail」)

对话购物MCP

一种MCP服务器,它将人工智能助手连接到SearchAgora,使用户能够通过自然语言对话在网页上搜索、发现和购买产品。

@Fewsats/agora-mcp

多平台商品搜索

一个服务器,它通过BigGo的价格比较API,实现跨多个电子商务平台搜索产品、追踪价格历史以及比较产品规格的功能。

@Funmula-Corp/BigGo-MCP-Server

优步外卖AI下单助手

一个概念验证的模型上下文协议服务器,使大型语言模型应用程序能够与Uber Eats互动,允许人工智能代理通过自然语言浏览和订购食物。

@ericzakariasson/uber-eats-mcp-server

Actors 微云服务器

使用 Apify 提供的 3,000 多种预构建云工具(称为 Actors),从网站、电子商务平台、社交媒体、搜索引擎、地图等提取数据。

@apify/actors-mcp-server

bayarcash-mcp-server

暂无描述。

@khairulimran-97/bayarcash-mcp-server

bayarcash-mcp-server

暂无描述。

@webimpianteam/bayarcash-mcp-server

自动安装

点击按钮会唤起 PolarBear 客户端,并把当前 MCP Server 的 Markdown 详情文档地址传给客户端。

/api/mcps/jlwainwright-shiplogic-mcp/markdown
打开 PolarBear 安装查看 Markdown 文档

手动安装

在 PolarBear 或其他支持 MCP 的客户端中,新建 MCP Server,并参考下方来源或安装提示配置。

暂未识别到安装命令,请打开 ModelScope 详情查看完整配置。

基本信息

分类
ecommerce-and-retail / travel-and-transportation / app-automation
运行方式
No
许可证
Unknown
详情文件
jlwainwright-shiplogic-mcp.md