面向 AI 发货助手的 MCP 服务器

通过 Model Context Protocol 让 AI 助手直接用 atoship 发货。用自然语言即可查运费、生成面单、追踪包裹并管理订单。

@atoship/mcp

v1.0.0

12 个工具

远程 MCP — 免安装

Claude.ai

在 Claude.ai 网页版中直接使用 atoship — 无需 npm,也无需配置文件。只要填入网址并连接即可。

打开 Claude.ai → Settings → Integrations
点击 Add integration
填入服务器网址:

https://atoship.com/api/mcp

Claude.ai 会跳转到 atoship.com 让你用自己的账户授权。连接完成后,全部 12 个工具及斜杠命令(/ship、/track、/rates)均可使用。

本地客户端(stdio)

将以下内容添加到你的 claude_desktop_config.json:

{
  "mcpServers": {
    "atoship": {
      "command": "npx",
      "args": ["-y", "@atoship/mcp"],
      "env": {
        "ATOSHIP_API_KEY": "ak_live_your_key_here"
      }
    }
  }
}

配置文件位置:~/Library/Application Support/Claude/claude_desktop_config.json(macOS)

获取你的 API 密钥

使用 MCP 服务器需要一个 atoship API 密钥。生产环境密钥以 ak_live_ 开头, 沙盒环境密钥以 ak_test_ 开头。

可用工具

12 个工具覆盖完整的发货流程。AI 助手会根据你的需求自动选择合适的工具。

get_shipping_rates

比较 USPS、FedEx、UPS 等多家承运商的运费

“帮我查一下从旧金山寄到纽约、2 磅包裹的最低运费”

purchase_label

用任意承运商和服务购买运输面单

“为这个订单生成一张 USPS Priority Mail 面单”

track_package

追踪包裹并查看完整的物流轨迹

“追踪 9400111899223456789012”

validate_address

校验地址并自动纠错

“校验 123 Main St, San Francisco, CA 94105”

create_order

按收件人和商品明细创建订单

“为 John Doe 在 456 Oak Ave 创建一个订单”

list_orders

按状态或日期搜索并筛选订单

“列出本周所有已发货的订单”

get_label

获取面单详情、追踪号和下载链接

“获取订单 #12345 的面单”

void_label

作废未使用的面单并申请退款

“作废我刚刚创建的那张面单”

list_labels

按筛选条件浏览所有运输面单

“列出今天购买的面单”

get_account

查看账户信息、套餐和用量统计

“我现在用的是哪个套餐?”

list_carrier_accounts

查看所有已配置的承运商账户

“我已经连接了哪些承运商?”

对话示例

寄一个包裹

我要把一个 12oz 的包裹从 123 Main St, San Francisco CA 94105 寄到 456 Oak Ave, New York NY 10001。哪种方式最便宜?

我为你的包裹找到了 5 种运输方案:

1. USPS Ground Advantage — $4.75(5-7 天)

2. USPS Priority Mail — $8.20(2-3 天)

3. UPS Ground — $9.45(5 天)

4. FedEx Ground — $10.12(5 天)

5. USPS Priority Express — $26.35(1-2 天)

最便宜的是 USPS Ground Advantage,$4.75。要我帮你购买这张面单吗?

追踪一个包裹

我的包裹到哪了?追踪号 9400111899223456789012

你的 USPS 包裹当前运输中 — 预计 2 月 14 日送达。

2 月 12 日 10:23 AM — 已到达处理中心,Queens NY

2 月 11 日 8:45 PM — 已离开处理中心,Newark NJ

2 月 10 日 2:30 PM — USPS 已揽收,San Francisco CA

配置

变量	是否必填	默认值	说明
`ATOSHIP_API_KEY`	必填	—	你的 atoship API 密钥
`ATOSHIP_BASE_URL`	可选	`https://atoship.com`	API 基础网址