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 比率以避免清算風險