mcpField
M
mcp-skydropx

mcp-skydropx

本地服务
github.com/codespar地图与出行2754 周前更新
代码仓库

关于 mcp-skydropx

mcp-skydropx 是面向墨西哥市场的 MCP 服务，对接 Skydropx 多承运商物流聚合平台，支持 Estafeta、DHL、FedEx、Redpack 等承运商。它适合需要通过 AI 管理寄件、面单与物流追踪的用户。

主要功能

  1. 01创建、查询与取消托运单
  2. 02获取运费报价并生成面单
  3. 03追踪包裹并查看事件
  4. 04验证地址并管理已保存地址
  5. 05预约与取消承运商取件
  6. 06通过 Webhook 接收物流事件

适用场景

  1. 01让 Agent 为墨西哥订单比较运费并生成面单
  2. 02批量查询包裹追踪状态
  3. 03自动预约承运商取件并管理取件记录

MCP 相关

该项目是 MCP 服务，向 MCP 客户端暴露 23 个工具，用于调用 Skydropx API 完成寄件、运费、面单、追踪与取件等操作。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "codespar-mcp-skydropx": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-skydropx"
      ],
      "env": {
        "SKYDROPX_API_TOKEN": "<SKYDROPX_API_TOKEN>"
      }
    }
  }
}
启动命令npx -y @codespar/mcp-skydropx
需要配置的环境变量
SKYDROPX_API_TOKEN密钥API token for Skydropx

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@codespar/mcp-skydropx0.2.2

工具

23

收录的工具列表 · 更新于 2 周前

参数类型必填说明
parcelsarray是包裹详情
address_tostring是目的地地址 ID
address_fromstring是始发地地址 ID

详细介绍

MCP Skydropx

适用于 Skydropx 的 MCP 服务——墨西哥多承运商物流聚合平台，支持 Estafeta、DHL、FedEx、Redpack 等。

快速开始

# Set your API token
export SKYDROPX_API_TOKEN="your-token"

# Run via stdio
npx tsx packages/mexico/skydropx/src/index.ts

# Run via HTTP
npx tsx packages/mexico/skydropx/src/index.ts --http

环境变量

变量必填描述
SKYDROPX_API_TOKEN是从 Skydropx 控制面板获取的 API 令牌
MCP_HTTP否设置为 "true" 以启用 HTTP 传输
MCP_PORT否HTTP 端口（默认值：3000）

工具（23）

工具用途
create_shipment创建货运单
get_shipment根据 ID 获取货运单
list_shipments列出货运单
get_rates获取货运单的运费
create_label为货运单创建运输标签
track_shipment跟踪货运单
list_carriers列出可用的承运商
create_address创建地址
get_address根据 ID 获取地址
cancel_shipment取消货运单
validate_address验证地址（邮编、城市、省份、国家/地区）
list_addresses列出已保存的地址
list_parcels列出已保存的包裹预设
get_label根据 ID 获取标签
list_labels列出标签
create_pickup预约承运商上门取件
list_pickups列出已预约的取件
cancel_pickup取消已预约的取件
get_tracker根据追踪器 ID 获取追踪器（事件）
list_trackers列出追踪器
create_webhook注册 webhook，以接收货运单/追踪器事件
list_webhooks列出已注册的 webhook
delete_webhook删除已注册的 webhook

身份验证

使用 Bearer token 身份验证。请从 Skydropx 控制面板 获取 API 令牌。

API 参考

企业版

需要为 Agent 付款设置治理、预算限额和审计跟踪？CodeSpar Enterprise 在这些 MCP 服务之上增加了策略引擎、付款路由和合规模板。

身份验证

启动服务前，请设置以下环境变量：

  • SKYDROPX_API_TOKEN （必填，机密） — Skydropx 的 API 令牌

请在提供商的开发者门户签发凭证：https://skydropx.readme.io。

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。