buy123 Vendor Portal buy123 供應商平台

• buy123 供應商後台資料查詢用 MCP server
• 供應商營運流程的唯讀查詢工具
• 支援 Claude Desktop 與 Claude Code 的本機 MCP 設定
• 互動式按需登入，token 僅儲存在本機
• 離線單元測試，方便安全地本機開發

Install Dev Dependencies

./.venv/bin/pip install -e '.[dev]'

Run Tests

Tests run offline and do not require a real API connection:

./.venv/bin/python -m pytest tests/

Integration tests that require a live API connection are opt-in and must be triggered manually after configuring valid credentials in .env.

Environment Variables

See .env.example for all configurable fields. The authentication token is managed automatically by the login flow and does not need to be set manually.

See LICENSE.

• MCP server for buy123 vendor portal data access
• Read-only query tools for vendor operations workflows
• Claude Desktop and Claude Code compatible local MCP configuration
• Interactive on-demand login flow with local token storage
• Offline unit test suite for safe local development

59 AI-callable tools — all query-only. Every tool returns the upstream API response envelope: { success, msg, data, pagination? }.

General Enumerations (no login required — 14 tools)

list_banks, list_bundle_types, list_bundle_delivery_notes, list_bundle_delivery_statuses, list_delivery_types, list_packaging_types, list_invoice_types, list_product_statuses, list_event_product_statuses, list_gross_profit_statuses, list_review_statuses, list_announcement_notify_levels, list_announcement_notify_scopes, list_announcement_notify_types

Query Tools (login required — 45 tools)

Not Supported

• Write operations (POST / PUT / DELETE)
• Attachment preview or download
• Excel or other binary file downloads
• Shipping label printing

Requirements

• Python 3.10+
• A legitimate vendor account on the buy123 platform

Install

git clone https://github.com/asgard-ai-platform/mcp-buy123-vendor.git
cd mcp-buy123-vendor

python3 -m venv .venv
./.venv/bin/pip install -e .

cp .env.example .env
# Edit .env and fill in your vendor credentials

Run as an MCP Server

./.venv/bin/python mcp_server.py

Claude Desktop Configuration

Edit ~/Library/Application Support/Claude/claude_desktop_config.json and replace <PROJECT_DIR> with the absolute path to this project:

{
  "mcpServers": {
    "buy123-vendor": {
      "command": "<PROJECT_DIR>/.venv/bin/python",
      "args": ["<PROJECT_DIR>/mcp_server.py"]
    }
  }
}

Restart Claude Desktop. The buy123-vendor server should appear as running under Settings → Developer.

Claude Code CLI

A .mcp.json is included at the project root. Running claude from this directory will pick it up automatically.

Authentication

The server uses on-demand login. When a query requires authentication and no valid token is cached, the MCP client will be prompted to complete the login flow interactively. A desktop environment (windowed display) is required for the login step.

59 個 AI 可呼叫工具 — 全部為唯讀查詢。所有工具均回傳上游 API 的回應封包：{ success, msg, data, pagination? }。

通用列舉（無需登入 — 14 個工具）

list_banks、list_bundle_types、list_bundle_delivery_notes、list_bundle_delivery_statuses、list_delivery_types、list_packaging_types、list_invoice_types、list_product_statuses、list_event_product_statuses、list_gross_profit_statuses、list_review_statuses、list_announcement_notify_levels、list_announcement_notify_scopes、list_announcement_notify_types

查詢工具（需登入 — 45 個工具）

不支援的功能

• 寫入操作（POST / PUT / DELETE）
• 附件預覽或下載
• Excel 或其他二進位檔案下載
• 出貨標籤列印