M

mcp-coordinadora

mcp-coordinadora

本地服务

github.com/codespar地图与出行2754 周前更新

关于 mcp-coordinadora

mcp-coordinadora 是面向哥伦比亚快递与物流公司 Coordinadora 的 MCP 服务，提供国内和国际运输相关功能。该项目为 alpha 版本，接口尚未完全实机验证。

主要功能

01运单的创建、查询与取消
02运单物流轨迹与历史查询
03运费报价与服务类型查询
04上门取件的预约与取消
05批量创建运单与退货运单

适用场景

01让 Agent 为哥伦比亚订单创建运单并查询轨迹
02批量生成运单以处理发货
03查询服务覆盖范围与取件安排

MCP 相关

该项目是一个 MCP 服务，向 MCP 客户端暴露 19 个工具，用于调用 Coordinadora API 完成运单、取件、报价和覆盖范围等操作。

配置

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

mcp.json · 通用配置

{
  "mcpServers": {
    "codespar-mcp-coordinadora": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-coordinadora"
      ],
      "env": {
        "COORDINADORA_API_KEY": "<COORDINADORA_API_KEY>",
        "COORDINADORA_NIT": "<COORDINADORA_NIT>"
      }
    }
  }
}

启动命令npx -y @codespar/mcp-coordinadora

需要配置的环境变量

COORDINADORA_API_KEY密钥API key for Coordinadora

COORDINADORA_NITCompany NIT number

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

安装包

npm@codespar/mcp-coordinadora0.2.0-alpha.3stdio

工具

19

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

参数	类型	必填	说明
sender	object	是	发件人信息
sender.nit	string	否	发件人 NIT/CC
sender.name	string	是	发件人姓名
sender.phone	string	是	发件人电话
sender.address	string	是	发送方地址
packages	array	是	待寄送的包裹
recipient	object	是	收件人信息
recipient.nit	string	否	收件人 NIT/CC
recipient.name	string	是	收件人姓名
recipient.phone	string	是	收件人电话
recipient.address	string	是	收款地址
origin_city	string	是	始发城市 DANE 代码
payment_type	string	否	付款类型（prepaid、collect、contra_entrega）
service_type	string	否	服务类型（standard、express、same_day）
destination_city	string	是	目的地城市 DANE 代码

详细介绍

MCP Coordinadora

Alpha 版本 — 通过 alpha npm dist-tag 发布。端点路径遵循公开文档和 BACEN/提供商约定，但尚未经过全面的线上验证。在 0.x.x-alpha 阶段，请固定使用确切版本。使用 npm install <pkg>@alpha 安装。

Coordinadora 的 MCP 服务——它是哥伦比亚规模最大的快递和物流公司之一，提供国内和国际运输服务。

快速开始

# Set your credentials
export COORDINADORA_API_KEY="your-api-key"
export COORDINADORA_NIT="your-nit"

# Run via stdio
npx tsx packages/colombia/coordinadora/src/index.ts

# Run via HTTP
npx tsx packages/colombia/coordinadora/src/index.ts --http

环境变量

变量	必填	描述
`COORDINADORA_API_KEY`	是	Coordinadora 的 API 密钥
`COORDINADORA_NIT`	是	公司 NIT 编号
`MCP_HTTP`	否	设置为 `"true"` 以启用 HTTP 传输
`MCP_PORT`	否	HTTP 端口（默认：3000）

工具（19）

工具	用途
`create_shipment`	创建新的货件
`get_shipment`	根据运单号获取货件详情
`track_shipment`	根据运单号追踪货件
`get_rates`	获取运输费率/报价
`list_cities`	列出可寄送的城市
`create_pickup`	安排上门取件
`get_coverage`	检查地点是否在服务覆盖范围内
`cancel_shipment`	取消货件
`get_guia_pdf`	下载 PDF 格式的 guía 标签（返回 base64 或 URL）
`get_pickup`	根据 ID 获取取件（recolección）详情
`cancel_pickup`	取消已安排的取件（recolección）
`get_tracking_history`	获取 guía 的完整追踪事件历史
`list_shipments_by_date`	列出指定日期范围内创建的 guías
`validate_coverage`	验证城市与邮政编码组合是否在服务覆盖范围内
`list_services`	列出指定始发地/目的地可用的服务类型
`list_offices`	列出 Coordinadora 分支机构（oficinas）
`create_return`	创建逆向物流退货 guía
`list_returns`	列出现有的退货 guías
`create_bulk_guias`	在单次批量操作中创建多个 guías

身份验证

使用 API 密钥 + NIT 标头身份验证。每次请求都会通过自定义标头发送 API 密钥和公司 NIT。

API 参考

Coordinadora API 文档

企业版

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

身份验证

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

COORDINADORA_API_KEY (必填，机密) — Coordinadora 的 API 密钥
COORDINADORA_NIT (必填) — 公司 NIT 编号

请通过提供商的开发者门户获取凭据：https://coordinadora.docs.apiary.io。

许可证

MIT

评论

支持 Markdown

登录后评论

第一次接触 MCP？

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

阅读入门指南

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