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 分