mcpField
M
mcp-melhor-envio

mcp-melhor-envio

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

关于 mcp-melhor-envio

mcp-melhor-envio 是 Melhor Envio 的 MCP 服务，Melhor Envio 是一个巴西的物流聚合平台。它面向需要比较多家承运商运费并管理发货流程的开发者与 Agent，通过 MCP 客户端调用运费计算、运单生成和物流跟踪等功能。

主要功能

  1. 01多承运商运费计算
  2. 02发货订单创建与取消
  3. 03运单生成与 PDF 打印
  4. 04物流跟踪与事件历史
  5. 05自提网点查询
  6. 06沙盒环境测试

适用场景

  1. 01比较不同承运商的运费报价
  2. 02在 AI 助手中创建发货订单并生成运单
  3. 03查询包裹的物流跟踪记录

MCP 相关

该项目是一个 MCP 服务，向 MCP 客户端暴露 18 个工具，涵盖运费、订单、运单、网点和账户查询等操作。

配置

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

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

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

安装包
npm@codespar/mcp-melhor-envio0.1.4

工具

18

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

参数类型必填说明
toobject是
to.postal_codestring是目的地 CEP
fromobject是
from.postal_codestring是始发地 CEP
productsarray是待配送的产品

详细介绍

@codespar/mcp-melhor-envio

Melhor Envio 的 MCP 服务——支持多承运商费率比较的物流聚合平台

npm License: MIT

快速开始

Claude Desktop

添加到 ~/.config/claude/claude_desktop_config.json：

{
  "mcpServers": {
    "melhor-envio": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-melhor-envio"],
      "env": {
        "MELHOR_ENVIO_TOKEN": "your-token",
        "MELHOR_ENVIO_SANDBOX": "true"
      }
    }
  }
}
Claude Code
claude mcp add melhor-envio -- npx @codespar/mcp-melhor-envio
Cursor / VS Code

添加到 .cursor/mcp.json 或 .vscode/mcp.json：

{
  "servers": {
    "melhor-envio": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-melhor-envio"],
      "env": {
        "MELHOR_ENVIO_TOKEN": "your-token",
        "MELHOR_ENVIO_SANDBOX": "true"
      }
    }
  }
}

工具（18 个）

工具用途
calculate_shipping计算多个承运商的运费
create_shipment创建发货订单
track_shipment根据订单 ID 跟踪发货
generate_label为订单生成运单
list_agencies列出某个位置附近的承运商揽收网点
cancel_shipment取消发货订单
get_balance获取当前账户余额
add_cart将发货订单添加到购物车，以便批量结账
checkout_cart结账购物车中的所有项目并付款
preview_label生成前预览运单
print_label打印/下载运单 PDF
get_shipment根据 ID 获取发货订单详情
list_shipments使用筛选条件列出所有发货订单
get_store获取店铺/公司信息
search_agencies按服务和位置搜索揽收网点
create_address创建并保存寄件人/收件人地址
list_services_available列出路线的可用运输服务
get_tracking_history获取包含事件的完整物流跟踪历史

身份验证

Melhor Envio 使用 Bearer 令牌进行身份验证。

沙盒/测试

Melhor Envio 提供沙盒 sandbox.melhorenvio.com.br。设置 MELHOR_ENVIO_SANDBOX=true 即可使用。

获取凭据
  1. 前往 Melhor Envio
  2. 创建账户
  3. 前往 API 设置并生成令牌
  4. 设置 MELHOR_ENVIO_TOKEN 环境变量

环境变量

变量必填说明
MELHOR_ENVIO_TOKEN是Melhor Envio 提供的 Bearer 令牌
MELHOR_ENVIO_SANDBOX否设置为 "true" 以启用沙盒模式

路线图

v0.2（计划中）
  • create_store — 在 Melhor Envio 中创建店铺
  • update_store — 更新店铺详情
  • get_receipt — 获取发货收据/运单
  • list_companies — 列出可用的物流公司
  • get_invoice — 获取发货订单的发票
v0.3（计划中）
  • batch_shipments — 在单个请求中创建多个发货订单
  • detailed_reports — 生成详细的物流报告
  • webhook_management — 注册、列出和删除 Webhook

想要贡献？提交 PR 或申请工具。

链接

企业版

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

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

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

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