MAX Exchange MCP Server

透過 Model Context Protocol (MCP) 將 MAX 交易所 API 整合至 Claude 等 AI 助理，讓 AI 可以直接查詢行情、管理帳戶、下單交易。

前置需求

Python 3.11+
MAX 交易所帳號與 API 金鑰（前往申請）

安裝與啟動

方法一：直接使用 uvx（推薦）

無需手動安裝，直接從 GitHub 執行：

uvx --from git+https://github.com/nicky512500/max-mcp maxmcp

方法二：本地安裝

git clone https://github.com/nicky512500/max-mcp
cd max-mcp
pip install -e .
maxmcp

環境變數設定

需提供 MAX API 金鑰，支援兩種方式：

方式一：.env 檔（建議）

在專案根目錄建立 .env：

MAX_API_KEY=your_access_key
MAX_API_SECRET=your_secret_key

方式二：系統環境變數

export MAX_API_KEY=your_access_key
export MAX_API_SECRET=your_secret_key

公開查詢功能（行情、K線等）不需要 API 金鑰。

在 Claude Desktop 中使用

編輯 Claude Desktop 設定檔（~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "max-exchange": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/nicky512500/max-mcp", "maxmcp"],
      "env": {
        "MAX_API_KEY": "your_access_key",
        "MAX_API_SECRET": "your_secret_key"
      }
    }
  }
}

重新啟動 Claude Desktop 後即可使用。

在 Claude Code 中使用

claude mcp add max-exchange -- uvx --from git+https://github.com/nicky512500/max-mcp maxmcp

可用功能一覽

公開資訊（無需 API 金鑰）

工具	說明
`get_markets`	取得所有可用交易市場列表
`get_currencies`	取得所有可用貨幣列表
`get_timestamp`	取得 MAX 伺服器目前時間
`get_ticker`	取得單一市場即時行情（最新價、買賣一口價、24h 量）
`get_tickers`	取得多個市場即時行情（可一次查詢多個）
`get_depth`	取得市場深度（掛單簿），最多 300 筆
`get_public_trades`	取得市場最近公開成交記錄
`get_k`	取得 K 線（蠟燭圖）資料，支援多種週期

K 線週期（分鐘）：1 / 5 / 15 / 30 / 60 / 120 / 240 / 360 / 720 / 1440

M 錢包公開資訊（無需 API 金鑰）

工具	說明
`get_m_index_prices`	取得 M 錢包各幣種指數價格
`get_m_limits`	取得 M 錢包可用借貸額度上限
`get_m_interest_rates`	取得 M 錢包各幣種借貸利率

帳戶管理（需 API 金鑰）

工具	說明
`get_user_info`	取得帳戶資訊（KYC 狀態、帳號 ID 等）
`get_accounts`	取得帳戶各幣種餘額（現貨或 M 錢包）
`get_deposit_address`	取得指定幣種的充值地址
`get_withdraw_addresses`	取得已綁定的提現地址列表

訂單管理（需 API 金鑰）

工具	說明
`submit_order`	提交買賣訂單
`get_open_orders`	取得目前未成交的掛單列表
`get_closed_orders`	取得已關閉的訂單（已成交、已取消等）
`get_orders_history`	依 ID 順序分頁取得訂單歷史
`get_order`	查詢單筆訂單詳情
`cancel_order`	取消單筆掛單
`cancel_orders`	批次取消某市場的掛單

訂單類型（ord_type）：limit / market / stop_limit / stop_market / post_only / ioc_limit

成交記錄（需 API 金鑰）

工具	說明
`get_trades`	取得個人歷史成交記錄
`get_order_trades`	取得特定訂單的所有成交明細

閃兌（需 API 金鑰）

工具	說明
`submit_convert`	執行幣種閃兌（即時換匯）
`get_convert`	查詢單筆閃兌詳情
`get_converts`	取得閃兌歷史記錄

存提款（需 API 金鑰）

工具	說明
`submit_withdrawal`	提交加密貨幣提現申請
`submit_twd_withdrawal`	提交台幣（TWD）出金申請
`get_withdrawal`	查詢單筆提現詳情
`get_withdrawals`	取得提現歷史記錄
`get_deposit`	查詢單筆存款詳情
`get_deposits`	取得存款歷史記錄
`get_internal_transfers`	取得平台內部轉帳記錄（MAX 用戶間互轉）
`get_rewards`	取得獎勵記錄（返傭、空投、利息獎勵等）

M 錢包（需 API 金鑰）

工具	說明
`get_m_ad_ratio`	取得 M 錢包 AD 比率（資產 / 借貸），低於門檻會觸發清算
`submit_m_loan`	向 M 錢包申請借貸
`get_m_loans`	取得 M 錢包借貸歷史記錄
`submit_m_transfer`	在現貨錢包與 M 錢包之間轉移資金
`get_m_transfers`	取得 M 錢包資金轉移記錄
`submit_m_repayment`	向 M 錢包還款
`get_m_repayments`	取得 M 錢包還款歷史記錄
`get_m_liquidations`	取得 M 錢包清算歷史記錄
`get_m_liquidation`	取得單筆 M 錢包清算詳情
`get_m_interests`	取得 M 錢包利息計費歷史記錄

使用範例

在 Claude 中直接用自然語言提問：

查詢 BTC/USDT 目前的價格

幫我看一下我的現貨帳戶餘額

查詢 btcusdt 最近 10 根 1 小時 K 線

幫我在 btcusdt 以限價 90000 掛買單 0.001 BTC

取消 btcusdt 所有未成交的買單

注意事項

提現、下單等操作為不可逆動作，請確認參數後再執行
API 金鑰請妥善保管，不要提交至版本控制
M 錢包涉及槓桿借貸，請確認 AD 比率以避免清算風險

MAX Exchange MCP Server

MAX Exchange MCP Server

前置需求

安裝與啟動

方法一：直接使用 uvx（推薦）

方法二：本地安裝

環境變數設定

在 Claude Desktop 中使用

在 Claude Code 中使用

可用功能一覽

公開資訊（無需 API 金鑰）

M 錢包公開資訊（無需 API 金鑰）

帳戶管理（需 API 金鑰）

訂單管理（需 API 金鑰）

成交記錄（需 API 金鑰）

閃兌（需 API 金鑰）

存提款（需 API 金鑰）

M 錢包（需 API 金鑰）

使用範例

注意事項

Resources

Looking for Admin?

Tools

Latest Blog Posts

MCP directory API