Metadata-Version: 2.4
Name: shippingtracker
Version: 0.1.2
Summary: Korean shipping tracker MCP server using SweetTracker API
Project-URL: Homepage, https://github.com/gws8820/shippingtracker
Project-URL: Repository, https://github.com/gws8820/shippingtracker
License-File: LICENSE
Requires-Python: >=3.13
Requires-Dist: mcp[cli]>=1.13.0
Requires-Dist: requests>=2.32.4
Description-Content-Type: text/markdown

# ShippingTracker MCP Server

한국 택배 추적을 위한 MCP (Model Context Protocol) 서버입니다. SweetTracker API를 사용하여 배송 추적 기능을 제공합니다.

## 기능

- `get_company_list()`: 지원하는 택배회사 목록 조회
- `track_shipping(company_code, tracking_invoice)`: 택배 추적

## 사전 요구사항

- [SweetTracker (스마트택배)](https://www.sweettracker.co.kr/) API 키

## 로컬 개발

### 1. 저장소 클론

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

### 2. 환경변수 설정

```bash
echo "SWEETTRACKER_API_KEY=YOUR_API_KEY" > .env
```

### 3. 실행

```bash
uv run python -m shippingtracker.main

# 또는 uvx로 실행
uvx --from . shippingtracker
```

## Claude Desktop과 연결

Claude Desktop의 설정 파일(`claude_desktop_config.json`)을 다음과 같이 설정해 주세요.

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

## 라이선스

이 프로젝트는 [MIT 라이선스](LICENSE)하에 배포됩니다.