harukibox

Name: harukibox
Author: harukibox.com

远程服务

harukibox.com商业与营销011 周前更新

代码仓库访问官网

关于 harukibox

harukibox 的 MCP 服务让 AI Agent 通过官方 Agent API 管理代购业务，涵盖商品、订单、买家和出货。它提供读写业务数据的工具，并支持新旧 MCP 协议路径。

主要功能

01列出、查询和创建商品
02查看订单、买家与出货
03全局搜索业务数据
04通过环境变量提供令牌
05支持新旧 MCP 协议路径

适用场景

01维护代购商品目录
02检查订单和买家信息
03查看待处理的出货
04搜索代购业务记录

MCP 相关

该 MCP 服务向 AI 客户端提供 harukibox 工具，用于读取和创建商品、查看订单与买家、列出出货及全局搜索。

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://harukibox.com/api/agent/mcp

一键复制安装命令

Claude CodeTerminalclaude mcp add --transport http com-harukibox-harukibox https://harukibox.com/api/agent/mcp

Cursor.cursor/mcp.json{"mcpServers":{"com-harukibox-harukibox":{"type":"http","url":"https://harukibox.com/api/agent/mcp"}}}在 Cursor 中打开

VS Code.vscode/mcp.json{"servers":{"com-harukibox-harukibox":{"type":"http","url":"https://harukibox.com/api/agent/mcp"}}}在 VS Code 中打开

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

Windsurf~/.codeium/windsurf/mcp_config.json{"mcpServers":{"com-harukibox-harukibox":{"serverUrl":"https://harukibox.com/api/agent/mcp"}}}

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

安装包

npm@harukibox/mcp0.2.1stdio

工具

详细介绍

来自项目 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 支援新版後會換回去。

安裝

npm install -g @harukibox/mcp

或在專案內：

npm install @harukibox/mcp

取得 API token

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

npm install -g @harukibox/cli
harukibox 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：

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

Refresh token (進階, 預設關閉)

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

"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 設定

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

可用工具

Tool	必要 scope	說明
`haruki_me`	`me`	取得當前 user/organization/token info
`haruki_list_products`	`products:read`	列出商品
`haruki_get_product`	`products:read`	取得單一商品
`haruki_create_product`	`products:write`	建立商品
`haruki_list_registrations`	`registrations:read`	列出訂單
`haruki_list_buyers`	`buyers:read`	列出買家
`haruki_list_shippings`	`shippings:read`	列出出貨
`haruki_search`	`search`	全域搜尋

安全

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

自架 / 私有部署

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

License

MIT

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。