mcpField
M
mcp-andreani

mcp-andreani

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

关于 mcp-andreani

mcp-andreani 是阿根廷物流公司 Andreani 的 MCP 服务，提供国内与国际快递相关操作。适合需要在 AI 助手中管理发货、跟踪与退货的阿根廷电商或物流团队。该包为 alpha 版本，端点尚未经过充分的实网验证。

主要功能

  1. 01创建发货单与生成运单标签
  2. 02按运单号跟踪物流与查看历史
  3. 03查询运费报价与邮编覆盖范围
  4. 04创建取件与退货（逆向物流）请求
  5. 05查询网点、合同产品与账单发票

适用场景

  1. 01为订单创建发货单并打印标签
  2. 02查询包裹的最新物流状态
  3. 03预约取件或登记退货
  4. 04核对账单与可用服务

MCP 相关

该服务以 MCP 服务的形式向客户端暴露 18 个工具，涵盖发货、跟踪、取件、退货和账单等操作。

配置

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

mcp.json · 通用配置
{
  "mcpServers": {
    "codespar-mcp-andreani": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-andreani"
      ],
      "env": {
        "ANDREANI_API_KEY": "<ANDREANI_API_KEY>",
        "ANDREANI_USER": "<ANDREANI_USER>",
        "ANDREANI_PASSWORD": "<ANDREANI_PASSWORD>"
      }
    }
  }
}
启动命令npx -y @codespar/mcp-andreani
需要配置的环境变量
ANDREANI_API_KEY密钥API key for Andreani
ANDREANI_USERUsername for Andreani
ANDREANI_PASSWORD密钥Password for Andreani

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

安装包
npm@codespar/mcp-andreani0.2.0-alpha.3

工具

18

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

参数类型必填说明
originobject否寄件地址
origin.citystring否城市
origin.numberstring否门牌号
origin.streetstring否街道名称
origin.provincestring否省
origin.postal_codestring是邮政编码
contractstring是合同／账号号码
packagesarray是待寄送的包裹
destinationobject是目标地址
destination.citystring否城市
destination.numberstring否门牌号
destination.streetstring否街道名称
destination.provincestring否省
destination.postal_codestring是邮政编码
destination.contact_namestring是收件人姓名
destination.contact_phonestring否收件人电话

详细介绍

MCP Andreani

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

Andreani 的 MCP 服务——阿根廷规模最大的快递和物流公司，提供国内和国际运输服务。

快速开始

# Set your credentials
export ANDREANI_API_KEY="your-api-key"
export ANDREANI_USER="your-username"
export ANDREANI_PASSWORD="your-password"

# Run via stdio
npx tsx packages/argentina/andreani/src/index.ts

# Run via HTTP
npx tsx packages/argentina/andreani/src/index.ts --http

环境变量

变量必填描述
ANDREANI_API_KEY是Andreani 提供的 API 密钥
ANDREANI_USER是用于身份验证的用户名
ANDREANI_PASSWORD是用于身份验证的密码
MCP_HTTP否设置为 "true" 以启用 HTTP 传输
MCP_PORT否HTTP 端口（默认值：3000）

工具（18 个）

工具用途
create_shipment创建新的货件
get_shipment按 ID 获取货件详情
track_shipment按追踪号码追踪货件
get_rates获取运费／报价
list_branches列出 Andreani 网点／分支机构
create_label为货件生成运输标签
get_tracking_history获取货件的完整追踪记录
cancel_shipment取消货件
get_label_pdf下载 PDF 格式的运输标签（Base64 编码）
list_tracking_by_date列出指定日期范围内某合同的追踪事件
validate_postal_code验证邮政编码的服务覆盖范围，并列出可用服务
create_pickup创建取件／收件请求（retiro）
list_pickups列出取件／收件请求
cancel_pickup取消取件／收件请求
create_return创建逆向物流货件（logística inversa／devolución）
list_returns列出逆向物流货件（退货）
list_products列出账户可用的签约产品／服务
get_invoice获取账单／发票详情

身份验证

使用 Bearer token 身份验证。服务端使用用户名和密码登录以获取 JWT 令牌，后续 API 调用将使用该令牌。同时也会包含 API 密钥标头。

API 参考

企业版

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

身份验证

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

  • ANDREANI_API_KEY （必填，机密） — Andreani 的 API 密钥
  • ANDREANI_USER （必填） — Andreani 的用户名
  • ANDREANI_PASSWORD （必填，机密） — Andreani 的密码

请通过服务提供商的开发者门户申请凭据：https://developers.andreani.com。

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

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

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