Shippingtracker

🚀 ShippingTracker MCP Server

このプロジェクトは、韓国の宅配便の配送状況を照会するためのMCP（Model Context Protocol）サーバーです。SweetTracker APIを使用して、宅配便会社のリストと運送伝票番号を照会できます。

🚀 クイックスタート

ShippingTracker MCP Serverを使って韓国の宅配便配送状況を簡単に照会できます。以下の手順に沿ってセットアップを行いましょう。

✨ 主な機能

• get_company_list(): サポートされている宅配便会社のリストを照会します。
• track_shipping(company_code, tracking_invoice): 配送状況を照会します。

📦 インストール

事前要件

• SweetTracker (スマート宅配便) のAPIキーが必要です。

ローカル開発手順

1. リポジトリのクローン

git clone https://github.com/gws8820/shippingtracker.git
cd shippingtracker

2. 環境変数の設定

echo "SWEETTRACKER_API_KEY=YOUR_API_KEY" > .env

3. 実行

uv run python -m shippingtracker.main

# またはuvxで実行
uvx --from . shippingtracker

💻 使用例

Claude Desktopとの接続

Claude Desktopの設定ファイル(claude_desktop_config.json)を以下のように設定してください。

{
  "mcpServers": {
    "shippingtracker": {
      "command": "uvx",
      "args": ["shippingtracker"],
      "env": {
        "SWEETTRACKER_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

📄 ライセンス

このプロジェクトは MITライセンス の下で配布されています。