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 整合