MAX Exchange MCP Server

Model Context Protocol (MCP) を通じて、MAX取引所のAPIをClaudeなどのAIアシスタントに統合し、AIが直接相場情報の照会、口座管理、注文の発注を行えるようにします。

前提条件

Python 3.11以上
MAX取引所のアカウントとAPIキー（申請はこちら）

インストールと起動

方法1：uvxを直接使用（推奨）

手動インストールは不要で、GitHubから直接実行します：

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

方法2：ローカルインストール

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

環境変数の設定

MAX APIキーの提供が必要です。以下の2つの方法をサポートしています：

方法1：.envファイル（推奨）

プロジェクトのルートディレクトリに.envを作成します：

MAX_API_KEY=your_access_key
MAX_API_SECRET=your_secret_key

方法2：システム環境変数

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`	単一市場のリアルタイム相場（最新価格、売買気配値、24時間出来高）を取得
`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

前提条件

インストールと起動

方法1：uvxを直接使用（推奨）

方法2：ローカルインストール

環境変数の設定

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