gobox-mcp

# gobox-mcp MCP server wrapping the Gobox Open API (`dev-api.gobox.asia/open/api/*`) for AI agents, Claude Desktop, and CLI automation. ## Features - **~40 tools** covering orders, products, SKU quantities, warehouses, reports, shops, locations, consignments, Goship rates, webhooks - **5 SKU quantity states**: available, in_warehouse, keep_pick, wait_qc, wait_incoming (+ composite `sku_full_status`) - **Dual transport**: stdio (Claude Desktop local) or SSE (Docker shared for bot/team) - **Auto token refresh** with in-memory cache - **Modular**: each tool group in its own file under `tools/` ## Setup ### 1. Credentials Contact Gobox admin for `client_id` + `client_secret`. ### 2. Install ```bash cd gobox-mcp python3 -m venv .venv && source .venv/bin/activate pip install -r requirements.txt cp .env.example .env # Edit .env with your credentials ``` ### 3. Run locally (stdio) ```bash python gobox_mcp.py ``` ### 4. Run in Docker (SSE) ```bash docker compose up -d # Test: curl http://localhost:8000/sse ``` ## Connect to Claude Desktop ### Stdio mode (local) Edit `~/Library/Application Support/Claude/claude_desktop_config.json`: ```json { "mcpServers": { "gobox": { "command": "/absolute/path/to/gobox-mcp/.venv/bin/python", "args": ["/absolute/path/to/gobox-mcp/gobox_mcp.py"], "env": { "GOBOX_BASE_URL": "https://dev-api.gobox.asia", "GOBOX_CLIENT_ID": "xxx", "GOBOX_CLIENT_SECRET": "xxx" } } } } ``` ### SSE mode (Docker) ```json { "mcpServers": { "gobox": { "url": "http://localhost:8000/sse" } } } ``` ## Connect to Claude Code ```bash claude mcp add gobox \ /absolute/path/.venv/bin/python \ /absolute/path/gobox_mcp.py \ -e GOBOX_BASE_URL=https://dev-api.gobox.asia \ -e GOBOX_CLIENT_ID=xxx \ -e GOBOX_CLIENT_SECRET=xxx ``` ## Environment switching (dev/prod) Set `GOBOX_BASE_URL` to switch: - Dev: `https://dev-api.gobox.asia` - Prod: `https://api.gobox.asia` (verify act…