Shiplogic MCP サーバー

Shiplogic Shipping APIとのシームレスな統合を実現するModel Context Protocol（MCP）サーバー。MCP SDKとTypeScriptを使用して構築されており、型安全性と優れた開発者エクスペリエンスを実現します。

デモ

# Example conversation with Claude:
User: "Get shipping rates from Cape Town to Johannesburg for a 2.5kg parcel"
Claude: "I'll check shipping rates for you..."

[Using tool: get_shipping_rates]
Result: Economy service - R95 (2-3 days delivery)

User: "Book the economy service"
Claude: "Creating shipment..."

[Using tool: create_shipment]
Result: Shipment created! Tracking: QR4FVL

特徴

🚚配送料を取得- 住所間の配送料を計算します
📦出荷を作成- 自動追跡で出荷を予約
🔍荷物の追跡- リアルタイムの配送追跡
❌出荷のキャンセル- 必要に応じて予約をキャンセル
➕オプションサービス- 特別サービスの追加料金にアクセス
📚アドレス帳管理- よく使うアドレスを保存して管理します

インストール

前提条件

Node.js 18歳以上
npmまたはyarn
Shiplogic API キー ( shiplogic.comで取得)

クイックスタート

クローンしてインストール:

git clone https://github.com/jlwainwright/shiplogic-mcp.git
cd shiplogic-mcp
npm install

環境を構成する:

cp .env.example .env
# Edit .env and add your Shiplogic API key

サーバーを構築します。

npm run build

使用法

クロード・デスクトップ

Claude Desktop の構成にこれを追加します:

{
  "mcpServers": {
    "shiplogic": {
      "command": "node",
      "args": ["/absolute/path/to/shiplogic-mcp/dist/index.js"],
      "env": {
        "SHIPLOGIC_API_KEY": "your_api_key_here"
      }
    }
  }
}

MCPインスペクターを使用

MCP Inspector を使用してサーバーをテストします。

npm run inspect

スタンドアロン

サーバーを直接実行します。

npm run dev

利用可能なツール

`get_shipping_rates`

2 つの住所間の配送料を計算します。

{
  collection_address: {
    street_address: string,
    city: string,
    code: string,
    country?: string,
    type?: "residential" | "business"
  },
  delivery_address: {
    street_address: string,
    city: string,
    code: string,
    country?: string,
    type?: "residential" | "business"
  },
  parcels: [{
    length: number,    // cm
    width: number,     // cm
    height: number,    // cm
    weight: number,    // kg
    description?: string
  }],
  declared_value?: number
}

`create_shipment`

追跡付きの新しい出荷を作成します。

{
  service_level_code: string,  // e.g., "ECO"
  collection_address: { /* same as above */ },
  delivery_address: { /* same as above */ },
  parcels: [{ /* same as above */ }],
  collection_contact: {
    name: string,
    mobile_number?: string,
    email?: string
  },
  delivery_contact: {
    name: string,
    mobile_number?: string,
    email?: string
  },
  customer_reference?: string,
  mute_notifications?: boolean
}

`track_shipment`

参照番号で出荷を追跡します。

{
  tracking_number: string
}

`cancel_shipment`

既存の出荷をキャンセルします。

{
  tracking_reference: string
}

`get_opt_in_rates`

オプションの追加サービス料金を取得します。

{
  collection_address: { /* address object */ },
  delivery_address: { /* address object */ }
}

`add_address_to_book`

アカウントのアドレス帳にアドレスを追加します。

{
  account_id: number,
  address: {
    street_address: string,
    city: string,
    code: string,
    country?: string,
    type?: "residential" | "business",
    company?: string
  },
  name?: string,            // Name for this address entry
  type?: "collection" | "delivery"  // Address type
}

`get_address_book`

アカウントのアドレス帳からアドレスを取得します。

{
  account_id: number,
  type?: "collection" | "delivery"  // Optional filter by type
}

`remove_address_from_book`

アカウントのアドレス帳からアドレスを削除します。

{
  account_id: number,
  address_id: number
}

構成

環境変数:

変数	説明	必須	デフォルト
`SHIPLOGIC_API_KEY`	Shiplogic APIキー	はい	-
`SHIPLOGIC_API_URL`	API ベース URL	いいえ	`https://api.shiplogic.com`

発達

プロジェクト構造

shiplogic-mcp-official/
├── src/
│   └── index.ts        # Main server implementation
├── dist/               # Compiled JavaScript (generated)
├── package.json
├── tsconfig.json
├── .env.example
└── README.md

スクリプト

npm run build - TypeScript をコンパイルする
npm run dev - ビルドして実行
npm run inspect - MCP Inspector で実行

テスト

# Run with MCP Inspector
npm run inspect

# In another terminal, test the tools
curl -X POST http://localhost:3000/tools/list

APIリファレンス

このサーバーはShiplogic API v2と統合されています。詳細なAPIドキュメントについては、以下をご覧ください。

ライセンス

MITライセンス - LICENSEファイルを参照

貢献

リポジトリをフォークする
機能ブランチを作成します（ git checkout -b feature/amazing-feature ）
変更をコミットする ( git commit -m 'Add amazing feature' )
ブランチにプッシュする ( git push origin feature/amazing-feature )
プルリクエストを開く

サポート

🐛 問題: GitHub の問題
📧 メールアドレス: your.email@example.com
📚 ドキュメント: Wiki
☕ 私の仕事に協力してください:コーヒーを買ってください

このプロジェクトが役に立つと思われた方は、ぜひ私の活動へのご支援をご検討ください。皆様のご支援は、私がオープンソース開発により多くの時間を費やし、コミュニティのためにより良いツールを開発する助けとなります。

謝辞

モデルコンテキストプロトコルSDKで構築
Shiplogic APIを搭載

ジャック・ウェインライトが❤️を込めて作りました

Shiplogic MCP Server

Integrations