ShipSaving

io.github.waka4674由 GitHub 账号 waka4674 发布v1.0.4更新于 Oct 24, 2026

MCP server for ShipSaving — shipping rates, labels, orders, tracking

发布方自己的服务:ship.page

已验证STDIO仅桌面效率与工作流商业与电商

概览

AI 生成的概览

ShipSaving MCP 服务器,让 AI 助手比价运费、购买与作废面单、管理订单、地址和包裹模板,并追踪包裹。

可以做什么
比较多家承运商运费,创建草稿运单、支付并生成面单、作废面单、搜索运单、追踪包裹,查询保险费率与服务等级,列出承运商和店铺。搜索、创建、标记已发货、取消订单,同步店铺订单,并为订单购买面单。查询、创建、更新和校验地址簿条目。列出并创建包裹模板,列出承运商预定义包装。查看节省金额、运费分析、钱包余额和交易记录。
适用场景
当你通过 ShipSaving 处理发货,并希望在对话助手中完成比价、购买或作废面单、处理店铺订单和追踪包裹,而不必打开网页后台时使用。
运行要求
通过 npx 在本地运行,需要 Node.js 18 或更高版本。需要 ShipSaving App Key,放在 SHIPSAVING_APP_KEY 环境变量中。可选配置包括 SHIPSAVING_API_BASE_URL、SHIPSAVING_TIMEOUT_MS 和 SHIPSAVING_LOG_FILE。需要能访问 ShipSaving API 的网络。
安装前请注意
应用密钥(SHIPSAVING_APP_KEY)是敏感凭据,可访问你的 ShipSaving 账户和钱包。支付运单会从钱包扣除真实资金;作废面单、取消订单、标记订单已发货和同步店铺订单都会改动线上数据。地址和订单信息会发送到 ShipSaving API。

安装

在 SourceWeft 中

  1. 打开 控制台中的 ShipSaving,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

ShipSaving MCP Server

[npm version] [License: MIT]

中文文档

An MCP (Model Context Protocol) server that wraps the ShipSaving logistics REST API, enabling AI assistants like Claude to perform shipping operations through natural language.

Features

  • Shipment Management — Multi-carrier rate comparison, create shipments, pay & generate labels, void labels, track packages
  • Order Management — Sync store orders, search, bulk label printing, mark as shipped, cancel
  • Address Book — Query, create, and validate addresses
  • Package Templates — Save and reuse package dimensions
  • Carriers — List connected carrier accounts and available service levels
  • Store Integration — List connected e-commerce stores (Shopify, etc.)
  • Analytics — Total savings, shipping cost analysis
  • Billing — Wallet balance, transaction history

Quick Start

Prerequisites

  • Node.js 18+
  • A ShipSaving App Key (get one at ShipSaving → Settings → API)

Install with Claude Code CLI (Recommended)

bash
claude mcp add shipsaving \  -e SHIPSAVING_APP_KEY=sk_your_app_key \  -- npx -y shipsaving-mcp

Install with Claude Desktop

Edit your config file:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
json
{  "mcpServers": {    "shipsaving": {      "command": "npx",      "args": ["-y", "shipsaving-mcp"],      "env": {        "SHIPSAVING_APP_KEY": "sk_your_app_key"      }    }  }}

Restart Claude Desktop after saving.

Verify Installation

bash
claude mcp list# shipsaving should show status: Connected

Available Tools

Shipment Management

ToolDescription
get_shipping_ratesCompare rates across multiple carriers, marks cheapest & fastest
create_draft_shipmentCreate a draft shipment (no payment yet)
pay_shipmentPay for shipment and generate label
void_labelVoid/refund an unused label
search_shipmentsSearch shipments by various criteria
get_shipment_detailGet detailed shipment information
track_shipmentTrack package by tracking number
get_insurance_ratesQuery shipping insurance rates

Order Management

ToolDescription
search_ordersSearch orders by status, store, date, keywords
get_order_detailGet order details
create_orderManually create an order
buy_label_from_orderPurchase a label for an existing order
mark_order_shippedMark order as shipped
cancel_orderCancel an order
sync_store_ordersTrigger store order sync
get_order_tagsList all order tags

Address Book

ToolDescription
list_addressesQuery address book entries
create_addressAdd a new address
update_addressUpdate an existing address
validate_addressValidate address deliverability

Package Templates

ToolDescription
list_packagesList saved package templates
list_predefined_packagesList carrier-provided package types
create_packageCreate a reusable package template

Carriers & Stores

ToolDescription
list_carriersList connected carrier accounts
get_service_levelsQuery available service levels per carrier
list_storesList connected e-commerce stores

Analytics & Billing

ToolDescription
get_total_savingsView total savings with ShipSaving
get_shipping_analysisAnalyze shipping data over time
get_wallet_infoQuery wallet balance
get_transaction_historyQuery transaction records

Usage Examples

Compare shipping rates:

Compare rates from ZIP 90001 to 10001 for a 10x8x6 inch, 2 lb package

Ship a package:

Ship from John Smith, 123 Main St, Los Angeles, CA 90001to Jane Doe, 456 Park Ave, New York, NY 10001Package: 10x8x6 inches, 2 lbs, choose cheapest option

Bulk label printing:

Sync my Shopify orders, then print labels for all pending ordersusing 6x6x6 inch boxes, 1 lb each, cheapest carrier, no insurance

Track a package:

Track package 1Z999AA10123456784

Environment Variables

VariableRequiredDefaultDescription
SHIPSAVING_APP_KEYYes—ShipSaving App Key (sk_ prefix)
SHIPSAVING_API_BASE_URLNohttps://app-gateway.shipsaving.comAPI base URL
SHIPSAVING_TIMEOUT_MSNo60000Request timeout in milliseconds
SHIPSAVING_LOG_FILENo—Path to log file (logs go to stderr by default)

Development

bash
# Install dependenciesnpm install
# Buildnpm run build
# Watch modenpm run dev
# Debug with MCP InspectorSHIPSAVING_API_BASE_URL=https://app-gateway.shipsaving.com \SHIPSAVING_APP_KEY=sk_your_app_key \npx @modelcontextprotocol/inspector node dist/index.js

Troubleshooting

"command not found" — Install Node.js 18+: nodejs.org

"Failed to connect" — Try running the server manually to see error output:

bash
SHIPSAVING_APP_KEY=sk_your_app_key npx -y shipsaving-mcp

If it hangs (waiting for input), the server started successfully. If it errors immediately, you'll see the issue.

To clear the npx cache:

bash
rm -rf ~/.npm/_npx

License

MIT

来源:README.md,提交 11b51cb

工具

0
SourceWeft 尚未在沙箱中启动过该软件包,因此其工具未知。

版本历史

1
  1. v1.0.4最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

其他 Ship 集成