convez.ai
MCP ServerIntegração & APIsIntermediário
easyparcel

EasyParcel CLI — MCP Server de Logística

easyparcel/easyparcel-cli

CLI e MCP para logística: cotações, rastreamento e gestão de parcelas

Ver no GitHub
InicialPluginScore · de 0 a 100

Interface de linha de comando e servidor MCP para a EasyParcel Open API (Malásia e Singapura). Permite consultar cotações de envios, rastrear parcelas, verificar saldo de crédito e gerenciar remessas — acessível tanto em terminal quanto como ferramenta de agentes de IA.

Instalação

$npx convez-ai easyparcel/easyparcel-cli

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 3 semanas
Versão
v0.1.8
Issues abertas
1
Contribuidores
1

Casos de uso

  • Comparar preços de entrega entre couriers antes de definir a melhor rota
  • Rastrear status de parcelas em tempo real via terminal ou assistente IA
  • Verificar saldo de crédito e gerenciar múltiplas contas (MYR/SGD)
  • Integrar automação de envios com ChatGPT/Claude para fluxos conversacionais
  • Validar cotações sem gastar crédito com mode dry-run

Veredito

Ferramenta bem estruturada para automação de logística em ambientes de IA. Suporta múltiplas contas e currencies; o setup via MCP é robusto. Limita-se ao ecossistema EasyParcel (MY/SG), exigindo Node.js 18+ ou binários pré-compilados.

README

A tradução para o português deste README ainda está na fila.

EasyParcel CLI

Ship parcels, compare courier rates, track deliveries, and check your wallet — straight from your terminal or through your favourite AI assistant.

easyparcel-cli is the command‑line tool for the EasyParcel Open API (Malaysia & Singapore). It's friendly for people and built for AI agents (ChatGPT/Claude‑style tools), with clean output and a one‑step login.

ep +rates --from 11950 --to 55100 --weight 1.5    # compare courier prices
ep +track EP123456789                              # where's my parcel?
ep wallet                                          # how much credit do I have?

The command is available under three names — ep, easyparcel, and easyparcel-cli — they all do the same thing. We'll use ep below.


Install

With npm (needs Node.js 18+):

npm install -g @easyparcel/cli

No Node? Download a ready‑to‑run app from the Releases page — pick your system, then run it directly:

  • Windows: easyparcel-windows-x64.exe
  • macOS (Apple Silicon): easyparcel-darwin-arm64
  • macOS (Intel): easyparcel-darwin-x64
  • Linux: easyparcel-linux-x64

On macOS/Linux, make it runnable first: chmod +x easyparcel-*.


1. Log in (one step)

ep auth login

Your browser opens, you approve, done — tokens are saved securely on your machine. No app registration, no API keys to copy.

Check anytime:

ep auth status

Have more than one EasyParcel account (e.g. a Malaysia account in MYR and a Singapore account in SGD)? Log them all in at once:

ep auth login --all

Then pick which to use per command (currency follows the account):

ep --profile sg +rates --from 049483 --to 018956 --weight 1   # quotes in SGD
ep --profile my wallet                                        # MYR balance

2. Everyday commands

What you wantCommand
Compare courier ratesep +rates --from <postcode> --to <postcode> --weight <kg>
Track a parcelep +track <AWB> [<AWB> …]
Wallet balanceep wallet
Your account infoep account info
Find a saved addressep +address "john"
Book a simple parcelep +ship --service-id … --collection-date … --weight … --sender-… --receiver-…
List your shipmentsep shipments

Anything that spends credit (booking, cancelling) supports --dry-run — it shows exactly what would be sent, without doing it:

ep shipment submit --dry-run --data @order.json

Prefer a table or spreadsheet? Add --format table or --format csv (default is JSON).

Not sure what a command needs? Ask the CLI:

ep --help                 # everything
ep shipment --help        # shipping commands
ep describe               # full machine‑readable list (handy for AI)

3. Use it with AI (ChatGPT / Claude / Cursor)

This is what the CLI is really built for. Two ways:

a) Plug it into an AI assistant as tools (recommended)

Add this to your AI client's MCP config (Claude Desktop, Claude Code, Cursor, …):

{
  "mcpServers": {
    "easyparcel": {
      "command": "npx",
      "args": ["-y", "@easyparcel/cli", "mcp"]
    }
  }
}

Restart the app, log in once with ep auth login, and then just chat: "Compare rates from 11950 to 55100 for a 1 kg parcel" — the assistant runs it for you.

b) Teach a coding assistant how to use it (Claude Code / Cursor "Skills")

ep skills install          # adds EasyParcel skills to this project
ep skills install --user   # …or for all your projects

c) Host it as a remote connector (ChatGPT apps / web MCP)

Run the server over HTTP instead of stdio and point a remote MCP client at it.

With OAuth (for ChatGPT connectors / public listing):

ep mcp --http --host 0.0.0.0 --port 8790 --oauth --public-url https://mcp.example.com

This turns the server into an OAuth 2.1 authorization‑server proxy: ChatGPT does discovery, dynamic client registration and the login flow against it, and it relays the actual sign‑in to EasyParcel's OAuth — each user logs in with their own EasyParcel account. Put it behind HTTPS and register https://mcp.example.com/mcp as the connector URL. (The EasyParcel app must allow https://mcp.example.com/oauth/callback as a redirect URI.)

With a pre‑issued token (simplest, for your own use):

ep mcp --http --require-auth

Clients authenticate per request with their own EasyParcel token (Authorization: Bearer <token>). Drop --require-auth for local testing (it then uses your logged‑in credentials).


4. For automation / servers (no browser)

Set a token in the environment and the CLI runs fully unattended:

export EASYPARCEL_ACCESS_TOKEN=...     # (and EASYPARCEL_REFRESH_TOKEN to auto‑renew)
ep wallet

Updating

ep upgrade            # update to the latest version  (`ep update` works too)
ep upgrade --check    # just check if there's a newer version

If you installed with npm, this runs npm i -g @easyparcel/cli@latest. For a downloaded binary, it points you to the latest release. The npx … mcp setup auto‑uses the latest.


Good to know

  • Where things are saved: ~/.easyparcel/ (config + login tokens, readable only by you).
  • Demo vs live: you're using whichever EasyParcel account you logged in with.
  • Exit codes (for scripts): 0 ok · 3 not logged in · 4 not found · 5 bad input · 6 rate‑limited · 7 some batch items failed.
  • Coverage: couriers for Malaysia (MY) and Singapore (SG).

Building / contributing

See AGENTS.md (architecture) and PUBLISHING.md (release steps).

npm install
npm run dev -- <args>     # run from source
npm run build             # bundle
npm run build:exe         # standalone binaries for all platforms

License

MIT © EasyParcel

Ver o original no GitHub

Bom para

Relacionados