Easyship

Easyship MCP — 用于配送与物流自动化的 AI Agent 插件

将所有 AI 工具连接到 Easyship 的全球配送平台，通过自然语言管理整个配送运营。

此插件可让你的 Agent 使用运费报价、创建货件、购买面单、追踪包裹、安排取件、验证地址、管理账单和分析数据。更多信息请参阅 API 文档。

直接通过 Cursor、Claude、Gemini、Codex 等工具使用遍及 200 多个国家和地区的 550 多家承运商服务，包括 UPS、FedEx、DHL Express、USPS、Canada Post、Australia Post 和 Royal Mail。

安装

• 适用于 Cursor：在 Settings -> Marketplace 中搜索 "easyship"，或通过 Settings -> Tools & MCP 手动添加。"

• 适用于 Claude Code：在聊天中运行以下两条命令：

  /plugin marketplace add easyship/easyship-mcp-plugin
  /plugin install easyship@easyship-mcp-plugin
  

• 适用于 Gemini CLI：在终端中运行此命令：

  gemini extensions install https://github.com/easyship/easyship-mcp-plugin
  

• 适用于 OpenAI Codex：在 Codex CLI 中， 添加到 ~/.codex/config.toml：

  [mcp_servers.easyship]
  url = "https://mcp.easyship.com/mcp"
  http_headers = { "Authorization" = "Bearer YOUR_TOKEN" }
  

• 适用于 VS Code：打开命令面板（CMD+SHIFT+P），并运行 Chat: Install Plugin From Source。 然后粘贴：

  https://github.com/easyship/easyship-mcp-plugin
  

你将获得

• 运费比较：比较 550 多种承运商选项，查看折扣费率、预计送达时间以及税费和关税估算
• 货件管理：端到端地创建、更新、追踪、取消和管理货件，包括购买面单和获取文件
• 安排取件：查看可用时段、安排承运商取件，并管理现有取件
• 地址验证：验证美国境内及国际目的地的配送地址
• 账单：查看交易和账单文件
• 分析：货件量趋势、热门目的地、承运商使用情况、状态细分和销售渠道表现

其他安装方式

如果你的平台不支持插件，可以直接安装 MCP 服务。

从 Easyship Dashboard → Connect → API 获取 API 令牌。

**提示：**将 .env.example 复制为 .env，并添加你的 API 令牌。某些本地配置会自动读取此文件。

⚠️ 安全提示：切勿在聊天窗口中分享 API 令牌。如果不慎将其粘贴到提示词中，请立即在 Easyship Dashboard 中撤销并轮换 API 密钥。

注意：MCP 操作没有单独的测试环境。任何会消耗额度的操作（例如生成面单）都会产生实际费用。建议首次运行时使用权限范围受限的测试 API 令牌。

以下每种客户端都提供两种连接方式：

方式	工作原理	需要 Python？
远程	通过 Streamable HTTP 连接到 mcp.easyship.com	否
本地	通过 uvx 在你的设备上运行 easyship-mcp 包	是

---

Claude Desktop

编辑配置前，请先退出 Claude Desktop；保存后再重新启动。

操作系统	配置文件
macOS	~/Library/Application Support/Claude/claude_desktop_config.json
Windows	%APPDATA%\Claude\claude_desktop_config.json

合并到顶层的 mcpServers 对象中（如果不存在则创建）。

远程：

{
  "mcpServers": {
    "easyship": {
      "url": "https://mcp.easyship.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

本地（uvx）：

{
  "mcpServers": {
    "easyship": {
      "command": "uvx",
      "args": ["easyship-mcp"],
      "env": {
        "EASYSHIP_API_ACCESS_TOKEN": "YOUR_TOKEN"
      }
    }
  }
}

需要在设备上安装 uv。

---

Claude Code

远程：

claude mcp add --transport http easyship \
  https://mcp.easyship.com/mcp \
  --header 'Authorization: Bearer YOUR_TOKEN'

本地（uvx）：

export EASYSHIP_API_ACCESS_TOKEN="YOUR_TOKEN"
claude mcp add easyship -- uvx easyship-mcp

---

Cursor

在项目的 .cursor/mcp.json 中添加（全局配置则添加到 ~/.cursor/mcp.json）：

远程：

{
  "mcpServers": {
    "easyship": {
      "url": "https://mcp.easyship.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

本地（uvx）：

{
  "mcpServers": {
    "easyship": {
      "command": "uvx",
      "args": ["easyship-mcp"],
      "env": {
        "EASYSHIP_API_ACCESS_TOKEN": "YOUR_TOKEN"
      }
    }
  }
}

---

VS Code

在项目的 .vscode/mcp.json 中添加：

远程：

{
  "servers": {
    "easyship": {
      "type": "http",
      "url": "https://mcp.easyship.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

本地（uvx）：

{
  "servers": {
    "easyship": {
      "type": "stdio",
      "command": "uvx",
      "args": ["easyship-mcp"],
      "env": {
        "EASYSHIP_API_ACCESS_TOKEN": "YOUR_TOKEN"
      }
    }
  }
}

---

Gemini CLI

gemini mcp add --transport http easyship \
  https://mcp.easyship.com/mcp \
  --header 'Authorization: Bearer YOUR_TOKEN'

---

Codex CLI

在 ~/.codex/config.toml 中添加：

[mcp_servers.easyship]
url = "https://mcp.easyship.com/mcp"
http_headers = { "Authorization" = "Bearer YOUR_TOKEN" }

---

其他客户端

对于支持 Streamable HTTP 的任何 MCP 客户端，将其指向：

URL:    https://mcp.easyship.com/mcp
Header: Authorization: Bearer YOUR_TOKEN

对于基于 stdio 的客户端，在环境中设置 EASYSHIP_API_ACCESS_TOKEN，然后运行 uvx easyship-mcp。

使用示例

获取运费：

“从香港寄往纽约的 1.5kg 包裹（30×20×15 cm）有哪些运输选项？”

追踪货件：

“追踪货件 ESSG10006001”

预约揽件：

“为货件 ESSG10006001 预约最早可选日期的揽件”

验证地址：

“验证此地址：215 Clayton St, San Francisco, CA 94117”

分析运输数据：

“我本季度最常寄往哪些目的地？”

“我最常使用哪家快递公司？”

需要帮助？

• Easyship API 文档
• Easyship MCP 文档
• Easyship 支持
• GitHub 问题

隐私政策

Easyship MCP Connector 是无状态代理，不会在自己的服务器上存储用户数据、凭据或货件信息。通过此 Connector 处理的所有数据均受 Easyship 的数据处理规范约束。

此 Connector 如何处理你的数据：

• **数据收集：**不会收集个人数据或货件内容。为监控目的，会记录运行请求元数据（端点、状态码、会话 ID）。
• **使用与存储：**访问令牌由你的 MCP 客户端（例如 Claude）持有，本服务绝不会将其写入磁盘或记录到日志中。
• **与第三方共享：**你的数据仅会发送至 Easyship API 以完成请求，并完全受 Easyship 系统管理。
• **保留：**此 Connector 不会保留个人数据或货件内容。为监控目的，会保留运行请求元数据日志。货件或个人数据的任何保留均完全由 Easyship 系统管理。
• **联系：**如对数据处理方式有疑问，请参阅 Easyship 隐私政策，或联系 [email protected]。

API 版本

此服务面向 Easyship API v2024-09。

许可证

MIT