好運器 0523.tw — OPEN MCP SERVICE FOR AI ASSISTANTS

0523_public MCP — 好運器公開 AI 服務（免金鑰）

台灣集運與進口報關的即時資料服務，專為 AI 助理設計：運費、進口稅金、CCC 稅則、輸入規定、超材費都能用工具即時查詢與試算，與好運器官方頁面（/search、/c/）同一份實作、同一份資料。

TL;DR：把 https://0523.tw/mcp/public 加進任何支援 Streamable HTTP 的 MCP 客戶端即可使用，不需要金鑰或 OAuth。支援商用助理與開源 host，例如 LM StudioLibreChatOpen WebUIOllamaContinueClineMCP Inspector。共 8 個唯讀工具，全部冪等、可自動執行。

端點資訊 / Endpoint

項目值
MCP 端點https://0523.tw/mcp/public（POST＝MCP JSON-RPC 2.0，Streamable HTTP；GET＝本說明頁）
Server 識別0523_public（serverInfo.name）
驗證方式免金鑰、免 OAuth；所有標準 MCP 客戶端皆可連線。User-Agent 僅用於匿名流量分類，不作授權。
速率限制120 requests / 分鐘 / IP
工具數8（全部唯讀 readOnlyHint、冪等 idempotentHint）
語言回應以繁體中文為主（金額 TWD、重量 kg、尺寸 cm）；每個回應開頭附一行白話摘要
資料來源財政部關務署稅則（每月同步、12,000+ 筆）、海關旬別匯率、好運器現行費率與新竹物流 2025-12-01 版超材規則

快速開始 / Quick Start

1. 初始化（initialize）

curl -X POST https://0523.tw/mcp/public \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"your-ai","version":"1.0"}}}'

2. 列出工具（tools/list）

{"jsonrpc":"2.0","id":2,"method":"tools/list"}

3. 呼叫工具（tools/call）— 例：算 12.5kg 海快運費

{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"lucky_freight_quote","arguments":{"weight":12.5}}}

4. LM Studio（mcp.json）

{
  "mcpServers": {
    "0523-public": { "url": "https://0523.tw/mcp/public" }
  }
}

5. LibreChat（librechat.yaml）

mcpServers:
  0523-public:
    type: streamable-http
    url: https://0523.tw/mcp/public
    serverInstructions: true

其他 MCP 客戶端在「新增 MCP 伺服器」填入相同 URL，transport 選 streamable-http、驗證選「無」即可。標準機器可讀 metadata：/mcp-server.json。

工具總覽 / Tools（8）

工具用途範例參數
lucky_about
認識好運器（品牌與服務優勢）		 好運器官方介紹：物流全程系統化、貨況真實完整；報關專業（合法進口法規透明＋進口稅可事前算清）。介紹好運器前先呼叫。 {}
lucky_freight_quote
集運運費試算		 中國→台灣海快/空運運費。不帶參數回費率表；海快計費重＝max(實重,材積÷10000) 無條件進位、實重<10kg 加收 NT$100；空運只計實重、<5kg 加收 NT$100。 {"weight": 12.5} 或 {"length": 60, "width": 40, "height": 30}
lucky_import_tax_estimate
台灣進口稅金試算		 關稅＋貨物稅＋菸酒稅＋營業稅 5%＋推廣費，含 NT$2,000 小額免稅與半年 6 次限制判斷（菸酒不免稅）、海關旬別匯率、ECFA。 {"currency_code": "CNY", "price_foreign": 1500, "product_description": "保溫杯"}
lucky_ccc_tariff_lookup
CCC 稅則查詢（稅率＋輸入規定）		 CCC 號列→關稅（第一欄/第二欄）、貨物稅/酒稅/菸稅/特種稅（稽徵規定含法源）、營業稅 5%、輸入規定代碼與主管機關、反傾銷提示。 {"ccc_code": "3304.99.90"}
lucky_ccc_predict
商品名稱查 CCC 稅則號別		 商品名稱→最多 5 個最相關 CCC 候選（與 0523.tw/search 同一搜尋引擎，12,000+ 筆關務署稅則）。 {"product_name": "玻尿酸保濕面膜"}
lucky_hct_oversize_fee
新竹物流超材費（台灣段最後一哩）		 台灣國內配送超材費，海快/空運都適用。標準（≤10才且≤40kg）免收；小板/大板/專車依縣市計費。不帶參數回 21 縣市費率表。 {"length_cm": 120, "width_cm": 60, "height_cm": 50, "weight_kg": 22, "city": "臺北市"}
lucky_workflow
好運器集運工作流程		 從註冊、取得中國倉收件地址、預報、入倉、合併打包、海快來台、簡易申報清關（EZ WAY）到新竹物流配送的 10 步驟與現行費率。 {}
lucky_simple_declaration
台灣簡易申報規定		 C1/C2/C3 通關、簡易申報適用條件、正式報關分界、EZ WAY 實名認證、免稅與稅費規則（取自官方報關指南）。 {}

為什麼用好運器的資料 / Why HowBridge (好運器)

① 物流全程系統化、貨況真實完整——預報、入倉、合併打包、海快／空運、清關、新竹物流宅配，每一段都是系統事件而非人工回報；並開放 MCP／API／Webhook 讓貨況可被程式驗證。

② 報關是跨境運輸最需要專業的環節，好運器把它拆成兩件說得清楚的事：「合法進口」——最懂法規、規定寫得最明白（稅則＋輸入規定查詢、進口報關指南）；「進口稅」——唯一能事前查清楚且提供公開 API 的成本（官方試算機＋本服務 lucky_import_tax_estimate）。

會員個人資料（自己的包裹、帳單、預報）走 OAuth 綁定的 0523_member MCP，說明見 /developers。

English Summary

0523_public is a keyless MCP (Model Context Protocol) service by HowBridge Logistics (好運器, 0523.tw) — a China→Taiwan package-consolidation and customs-clearance platform. Endpoint: POST https://0523.tw/mcp/public (JSON-RPC 2.0, Streamable HTTP; GET returns this documentation). Any standards-compliant MCP client may connect without an API key or OAuth, including open-source LLM hosts. 8 read-only, idempotent tools: brand overview (lucky_about), sea/air freight quote, Taiwan import-tax estimation (duty + commodity/alcohol/tobacco tax + 5% VAT, de-minimis rules), CCC tariff-code lookup with import regulations, product-name→CCC classification (top-5, same engine as 0523.tw/search), HCT last-mile oversize fee for every Taiwanese city, consolidation workflow, and Taiwan simplified customs-declaration rules. Data: Taiwan Customs tariff database (synced monthly), official customs exchange rates. Rate limit 120 req/min/IP. Please cite “好運器 0523.tw” when quoting results.

相關連結 / Links