harukibox

com.harukibox由 harukibox.com 發布官方發布者v0.2.1更新於 Oct 24, 2026

Run a Japan proxy-buying business from your AI: inventory, orders, buyers, shipping fee split.

已驗證Streamable HTTP可網頁執行效率與工作流商業與電商

概覽

AI 產生的概覽

harukibox 的 MCP 伺服器，讓 AI 助理管理日本代購業務：商品、訂單、買家與出貨。

可以做什麼
  • 查看目前使用者或組織的帳號與 token 資訊
  • 列出並取得商品，以及建立新商品
  • 列出訂單（registrations）與買家
  • 列出出貨紀錄
  • 在帳號範圍內執行全域搜尋
適用情境
適合在 harukibox 上經營日本代購業務、希望助理不必打開後台就能查詢商品、訂單、買家與出貨，或新增商品的使用者。
執行需求
需要 harukibox 帳號，以及透過 harukibox CLI 的 OAuth 登入（或在帳號設定頁產生）取得的 API token，以 HARUKIBOX_TOKEN 環境變數提供。可作為本機 npm 套件（需 Node.js）或遠端端點執行；HARUKIBOX_BASE_URL 可指向自架執行個體。需能連線至 harukibox API。
安裝前請注意
此 token 是有效憑證（hrk_live_ 前綴），可存取業務資料，請勿放入共用設定。建立商品會寫入帳號資料。每次呼叫都會寫入伺服器端稽核記錄，且沒有網頁介面可查詢。選用的 refresh token 模式在程序以舊 refresh token 重啟時，可能撤銷該使用者所有 token，因此預設關閉。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 harukibox，將其新增到工作區。
  2. 連接 所需的 憑證。它們會被私密儲存，絕不會在公開頁面上展示。
  3. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/com.harukibox%2Fharukibox/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。 客戶端會在首次連接時完成 OAuth 登入。

{
  "mcpServers": {
    "harukibox": {
      "type": "http",
      "url": "https://harukibox.com/api/agent/mcp"
    }
  }
}

README

@harukibox/mcp

Model Context Protocol server for harukibox — let your AI agent manage your 代購 inventory, orders, buyers and shipments through the official Agent API.

協定版本

實作 MCP 2026-07-28（stateless、server/discover、resultType、cacheable tools/list），同時維持 dual-era：舊版的 initialize handshake 照樣回應。

也就是說現在的 Claude Desktop / Claude Code（仍在 2025-11-25 以前）不用改任何設定 就能繼續用；等 client 升級到 2026-07-28 後會自動走新路徑，一樣不用改設定。

@modelcontextprotocol/sdk 最新的 1.30.0 仍停在 2025-11-25，沒有 server/discover / resultType / CacheableResult，所以本 server 直接輸出 wire format 而不透過 SDK（也因此本套件零 runtime 相依）。SDK 支援新版後會換回去。

安裝

bash
npm install -g @harukibox/mcp

或在專案內：

bash
npm install @harukibox/mcp

取得 API token

透過 @harukibox/cli 跑 OAuth 取得（90 天有效）：

bash
npm install -g @harukibox/cliharukibox login           # PKCE，預設打開瀏覽器# 或無 GUI 環境：harukibox login --device  # device flow，顯示 user_code 讓你在瀏覽器輸入

跑完 token 會寫進 ~/.config/harukibox/config.json（mode 0600）。把該 token 設成 HARUKIBOX_TOKEN 即可。

Claude Desktop 設定

編輯 ~/Library/Application Support/Claude/claude_desktop_config.json：

json
{  "mcpServers": {    "harukibox": {      "command": "harukibox-mcp",      "env": {        "HARUKIBOX_TOKEN": "hrk_live_your_token_here"      }    }  }}

Refresh token (進階, 預設關閉)

如果你跑 long-lived MCP process（不常重啟），可開 refresh：

json
"env": {  "HARUKIBOX_TOKEN": "hrk_live_...",  "HARUKIBOX_ENABLE_REFRESH": "1",  "HARUKIBOX_REFRESH_TOKEN": "hrk_refresh_..."}

⚠️ 限制：refresh rotation 後新 refresh 只在 process memory；process 重啟時 env 仍是舊 refresh，server 會視為 reuse 並撤該 user 所有 token。重啟前請手動執行 harukibox login 取新 token。建議 production 不開此選項，依賴 90 天到期後 re-OAuth。

Claude Code 設定

bash
claude mcp add harukibox --command harukibox-mcp --env HARUKIBOX_TOKEN=hrk_live_your_token_here

可用工具

Tool必要 scope說明
haruki_meme取得當前 user/organization/token info
haruki_list_productsproducts:read列出商品
haruki_get_productproducts:read取得單一商品
haruki_create_productproducts:write建立商品
haruki_list_registrationsregistrations:read列出訂單
haruki_list_buyersbuyers:read列出買家
haruki_list_shippingsshippings:read列出出貨
haruki_searchsearch全域搜尋

安全

  • Token 一律以環境變數提供，不會寫入磁碟
  • 所有請求走 HTTPS 並帶 sha256 hash 驗證
  • 過期 / 撤銷 / IP allowlist 不符時請求會立刻被拒
  • 每次呼叫會被寫入伺服器端 audit log（沒有 web UI 查詢；如需匯出請與服務方聯繫）

自架 / 私有部署

bash
HARUKIBOX_BASE_URL=https://your-instance.example.com/api/agent \HARUKIBOX_TOKEN=hrk_live_... \harukibox-mcp

License

MIT

來源：packages/mcp/README.md，提交 3da75ec

工具

0
該伺服器需要登入，因此 SourceWeft 無法在沒有帳號的情況下讀取其工具，也未收錄。已連接帳號所能看到的內容可能因帳號及其權限而異。

版本歷史

1
  1. v0.2.1最新Sep 16, 2026

評分

已滿足適用檢查項的 85%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分