広告掲載
MCP.so
ログイン

PostEx MCP Server

@faizan45640

リポジトリ

基本情報

カテゴリ

その他

トランスポート

stdio

作者

faizan45640

PostEx MCP Server について

MCP server providing tools to interact with the PostEx Merchant API for order management, tracking, and other logistics operations.

#postex#mcp-server#api-tools

PostEx MCP Server の設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

{
  "mcpServers": {
    "PostEx-MCP-Server": {
      "command": "node",
      "args": [
        "index.js",
        "<YOUR_POSTEX_API_TOKEN>"
      ]
    }
  }
}

PostEx MCP Server のツール

14

Get a list of cities where PostEx operates.

Get the merchant's registered pickup addresses.

Create a new pickup address for the merchant.

Get the types of orders supported (e.g., "Normal", "Reverse").

Create a new order in the PostEx system.

List orders created but not yet booked for pickup within a date range.

Track a single order using its tracking number.

Track multiple orders using a list of tracking numbers. (Note: API docs specify GET but require a body; implementation uses GET as per latest code change, which might not work as expected with a body).

Provide advice (e.g., retry, return) for an attempted parcel.

Retrieve shipper advice history for a tracking number.

Cancel an order using its tracking number. (Note: Implemented as PUT with a JSON body).

Check the payment settlement status for an order.

Get a list of all possible order statuses.

List orders within a date range, optionally filtered by status ID.

概要

What is PostEx MCP Server?

An MCP server that provides tools for interacting with various endpoints of the PostEx Merchant API (v4.1.9). It is intended for developers who need to manage PostEx orders, addresses, tracking, and related operations through a standardized protocol.

How to use PostEx MCP Server?

Install dependencies (@modelcontextprotocol/sdk, zod, node-fetch@2), then run the server with Node.js, passing your PostEx API token as a command-line argument: node index.js <YOUR_POSTEX_API_TOKEN>. The server connects via standard I/O and listens for MCP requests.

Key features of PostEx MCP Server

  • Exposes 14 tools covering order, address, and tracking operations.
  • Validates input parameters using Zod schemas.
  • Securely passes API token via command line.
  • Graceful shutdown on SIGINT and SIGTERM signals.
  • Uses node-fetch for HTTP requests to PostEx API.

Use cases of PostEx MCP Server

  • Automate order creation and booking from an AI assistant.
  • Retrieve operational cities and merchant addresses for logistics workflows.
  • Track single or multiple orders programmatically.
  • Manage shipper advice (retry/return) for failed deliveries.
  • Cancel orders and check payment settlement status.

よくある質問

1

What runtime and dependencies are required?

Node.js (LTS recommended) and npm/yarn. Dependencies include `@modelcontextprotocol/sdk`, `zod`, and `node-fetch@2`.

2

How do I obtain an API token?

A valid PostEx Merchant API Token must be obtained from your PostEx merchant account or representative.

3

Which PostEx API endpoints are not implemented?

Endpoints that return PDF files (`generate-load-sheet`, `get-invoice`) are not implemented in this version.

4

How does authentication work?

The API token is passed as a command-line argument and used in the `Authorization` header for all API calls.

5

How is the server connected to MCP?

The server uses standard I/O for communication and logs status messages to standard error.

コメント

「その他」の他のコンテンツ

Glasswarp

Glasswarp

See and control a real Windows PC you own — from any MCP client, locally or remotely. Observe (UIA + screenshots), click/type/drag/scroll, launch apps, owner Live View. BYOH: your machine, your key.

Senso MCP for Joomla

sensomedia

Senso MCP turns a Joomla 5 or 6 site into a remote MCP server. It runs inside Joomla itself (no extra server, no Node.js bridge) and is secured with OAuth 2.1 and Joomla's own ACL. The free pack lets an AI assistant crea

Volley.sh

Volley

A good sequence diagram can solve almost any communication problem in engineering. Volley lets your agent write them as plain text, with the real request and response payloads on every arrow. It checks its own syntax wi

Screenpipe

screenpipe

YC (S26) | Open Computer History | Continuously record your company computer work, map your workflows, help you find work worth automating, and power your agents' context

22.0K

MCP Toolbox for Databases

googleapis

MCP Toolbox for Databases is an open source MCP server for databases.

15.9K
広告掲載