Shippingtracker

🚀 ShippingTracker MCP Server

This is an MCP (Model Context Protocol) server for querying South Korean courier deliveries. It uses the SweetTracker API to query the list of courier companies and tracking numbers.

🚀 Quick Start

This server is designed to query South Korean courier deliveries. It utilizes the SweetTracker API to obtain the list of supported courier companies and perform shipping tracking.

✨ Features

• get_company_list(): Query the list of supported courier companies.
• track_shipping(company_code, tracking_invoice): Track the shipping status.

📦 Installation

Prerequisites

• SweetTracker API key

Local Development

1. Clone the repository

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

2. Set environment variables

echo "SWEETTRACKER_API_KEY=YOUR_API_KEY" > .env

3. Run the server

uv run python -m shippingtracker.main

# Or run with uvx
uvx --from . shippingtracker

💻 Usage Examples

Connecting with Claude Desktop

Please configure the Claude Desktop configuration file (claude_desktop_config.json) as follows:

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

📄 License

This project is distributed under the MIT License.