Upbit MCP Server

Upbit MCP サーバー

Model Context Protocol（MCP）を使用した、Upbit 暗号資産取引所 OpenAPI のサーバー実装です。このプロジェクトは、Upbit 取引所のサービスを操作するためのツールを提供します。市場データ（相場、オーダーブック、取引履歴、チャートデータ）の取得、アカウント情報の確認、注文の作成とキャンセル、入出金の管理、テクニカル分析などを行えます。

機能

• 市場データの取得（ティッカー、オーダーブック、取引、ローソク足データ）
• アカウント情報（残高、注文履歴）
• 注文の作成とキャンセル
• 入金・出金機能
• テクニカル分析ツール

実行可能な機能一覧

市場データの取得

• 暗号資産の現在価格を取得（get_ticker）
• オーダーブック情報を取得（get_orderbook）
• 直近の約定履歴を取得（get_trades）
• 主要な暗号資産市場の概要を確認（get_market_summary）

アカウント情報の取得

• 保有資産の一覧と残高を確認（get_accounts）
• 注文履歴を取得（get_orders）
• 特定の注文の詳細情報を取得（get_order）
• 入出金履歴を取得（get_deposits_withdrawals）

取引機能

• 指値／成行の買い注文を作成（create_order）
• 指値／成行の売り注文を作成（create_order）
• 注文をキャンセル（cancel_order）

チャットの例

以下は実際のチャット例の画像です。

前提条件

開始する前に、Upbit API キーを取得してください。

1. まだアカウントをお持ちでない場合は、Upbit でアカウントを作成します
2. Upbit Developer Center にアクセスします
3. 新しい API キーを作成します
4. 適切な権限（必要に応じて、読み取り、取引、出金）を設定してください
5. API キー（UPBIT_ACCESS_KEY、UPBIT_SECRET_KEY）を .env ファイルに保存します（「インストール」セクションを参照）

インストール

1. リポジトリをクローンします。

   git clone https://github.com/solangii/upbit-mcp-server.git
   cd upbit-mcp-server
   

2. 依存関係をインストールします。

   cd upbit-mcp-server
   uv sync
   

   uv がまだインストールされていない場合は、次の手順でインストールできます。

   uv を使用すると、インストールが速くなり、依存関係をより確実に解決できます。

   # Install uv
   curl -Ls https://astral.sh/uv/install.sh | sh
   
    # Add uv to your PATH
   echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
   source ~/.zshrc  # or bashrc, depending on your shell
   

3. 環境変数を設定します。 プロジェクトのルートに .env ファイルを作成し、Upbit API キーを追加します。

   UPBIT_ACCESS_KEY=your_access_key_here
   UPBIT_SECRET_KEY=your_secret_key_here
   

使用方法

Claude Desktop にインストール

方法 1：Claude 設定ファイルを使用（直接統合）

MCP サーバーを Claude の設定ファイルに直接追加できます。

1. Claude Desktop をインストールします

2. 以下のファイルを Claude Desktop の設定に追加します。

   • macOS：``~/Library/Application Support/Claude/claude_desktop_config.json`
   • Windows：%APPDATA%\Claude\claude_desktop_config.json

3. 以下の設定を追加します（必要に応じてパスを調整してください）。

   {
     "mcpServers": {
       "upbit-mcp-server": {
         "command": "/full/path/to/upbit-mcp-server/.venv/bin/python",
         "args": [
           "/full/path/to/upbit-mcp-server/main.py"
         ]
       }
     }
   }
   

4. Claude を再起動して、新しい設定を読み込みます。

方法 2：fastmcp を使用

fastmcp install main.py --name "Upbit API"

Python で直接実行

uv run python main.py

開発モード（Web インターフェース）

fastmcp dev main.py

注意事項

• このサーバーは実際の取引を処理できるため、慎重に使用してください。
• API キーを安全に保管し、公開リポジトリに絶対にコミットしないでください。

ライセンス

MIT