OKX MCP Server

OKX MCP サーバー

このプロジェクトは、OKX 取引所からリアルタイムの暗号資産データを取得する Model Context Protocol（MCP）サーバーを作成します。定義済みのツールを通じて、Claude などの AI アシスタントが最新の暗号資産価格情報や過去のデータにアクセスできます。視覚化機能の強化や、WebSocket によるライブ更新にも対応しています。

機能

• get_price：視覚的に整形された暗号資産取引ペアの最新価格データを取得します
• get_candlesticks：ASCII チャートなどの視覚化オプションを使って、過去のローソク足データを取得します
• subscribe_ticker：取引ペアのリアルタイム WebSocket 更新を購読します
• get_live_ticker：WebSocket 接続から最新のライブデータを取得します
• unsubscribe_ticker：特定の取引ペアの更新受信を停止します

前提条件

• Node.js（v16 以降を推奨）
• npm または yarn
• Claude 拡張機能をインストールした VSCode（VSCode 連携を使用する場合）
• Claude Desktop（VSCode を使用しない場合）

インストール

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

   git clone https://github.com/yourusername/okx-mcp-server.git
   cd okx-mcp-server
   

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

   npm install
   

3. WebSocket の依存関係を追加します

   npm install ws
   npm install --save-dev @types/ws
   

4. プロジェクトをビルドします

   npm run build
   

5. コンパイル済みスクリプトを実行可能にします

   chmod +x build/index.js
   

使用方法

サーバーを直接実行する

次のコマンドでサーバーを直接実行できます：

npm start

または：

node build/index.js

MCP Inspector でテストする

連携する前に、MCP サーバーをテストできます：

npx @modelcontextprotocol/inspector node build/index.js

Inspector では、次の項目をテストできます：

• get_price の入力：{ "instrument": "BTC-USDT", "format": "markdown" }
• get_candlesticks の入力：{ "instrument": "BTC-USDT", "bar": "1m", "limit": 10, "format": "markdown" }
• subscribe_ticker の入力：{ "instrument": "BTC-USDT" }
• get_live_ticker の入力：{ "instrument": "BTC-USDT", "format": "markdown" }
• unsubscribe_ticker の入力：{ "instrument": "BTC-USDT" }

各ツールは、さまざまな視覚化形式に対応しています：

• format：markdown、json、または table（ローソク足用）から選択します

VSCode との連携

1. VSCode 用の Claude 拡張機能をインストールします

2. VSCode の設定で MCP サーバーを設定します：

   • 次のファイルを作成または編集します：

     ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
     

   • 次の設定を追加します：

     {
       "mcpServers": {
         "okx": {
           "command": "node",
           "args": ["/absolute/path/to/okx-mcp-server/build/index.js"],
           "disabled": false,
           "autoApprove": []
         }
       }
     }
     

   • /absolute/path/to/okx-mcp-server/build/index.js を実際のファイルパスに置き換えます

3. VSCode を再起動するか、Claude 拡張機能を再読み込みします

Claude Desktop との連携

Claude Desktop を使用する場合は、MCP 設定を配置する適切な場所について、公式ドキュメントを確認してください。

プロンプトの例

連携後、Claude に次のように尋ねることができます：

1. 「Bitcoin（BTC-USDT）の現在の価格はいくらですか？見やすく整形して表示してください。」
2. 「Ethereum（ETH-USDT）の過去 1 時間の価格推移を、5 分間隔で視覚的に表示してください。」
3. 「BTC-USDT と ETH-USDT の現在価格を比較してください。」
4. 「SOL-USDT の直近 20 本のローソク足を 1 分間隔で分析し、表形式で表示してください。」
5. 「BTC-USDT の現在価格は 24 時間高値より高いですか、低いですか？価格帯を視覚化してください。」
6. 「Bitcoin の価格のライブ更新を購読し、価格が変動したら教えてください。」
7. 「Ethereum の最新リアルタイムデータを表示してください。」
8. 「BTC-USDT をリアルタイムで監視し、価格が上下どちらかに 1% を超えて動いたら知らせてください。」

データ視覚化機能

強化された MCP サーバーは、豊富なデータ視覚化機能を提供します：

価格データの可視化

• 価格情報が明確な、書式設定済みの Markdown 出力
• 現在価格が24時間の高値／安値の間のどこに位置するかを示す、視覚的な価格範囲バー
• 価格変動を示す方向インジケーター（▲/▼）
• 読みやすさを高める書式設定済みの数値

ローソク足データの可視化

• Markdown 形式：要約統計、価格変動の ASCII チャート、直近の値動きテーブルを含みます
• テーブル形式：ローソク足データを見やすい表形式で表示します
• JSON 形式：プログラムで使用するための生データです

形式のオプション

• get_price：markdown（デフォルト）または json 形式に対応しています
• get_candlesticks：markdown（デフォルト）、table、または json 形式に対応しています
• get_live_ticker：markdown（デフォルト）または json 形式に対応しています

WebSocket によるリアルタイム更新

このサーバーには、OKX からライブデータを受信するための WebSocket サポートが含まれています。

WebSocket の仕組み

• OKX の WebSocket API への永続的な接続を確立します
• 価格が変動するたびにプッシュ更新を受信します
• 購読中の各金融商品について最新データのキャッシュを維持します
• 接続が失われた場合は自動的に再接続します

WebSocket ツール

• subscribe_ticker：リアルタイムのティッカー更新の購読を開始します
• get_live_ticker：アクティブな購読から最新データを取得します
• unsubscribe_ticker：監視が不要になったときに購読を終了します

リアルタイム更新のユースケース

• 価格変動をリアルタイムで監視する
• 価格アラートを設定する
• 市場のボラティリティを発生時に追跡する
• 最新データに基づいて、情報に基づいた取引判断を行う

環境変数（任意）

この基本実装では、認証が不要な OKX の公開 API エンドポイントを使用します。認証が必要なエンドポイントを使用するようにサーバーを拡張する場合は、次の環境変数を追加できます。

OKX_API_KEY=your_api_key
OKX_API_SECRET=your_api_secret
OKX_API_PASSPHRASE=your_api_passphrase

セキュリティに関する注意事項

• 現在の実装では公開 OKX API エンドポイントのみを使用するため、API キーは不要です
• コードベースに機密データは保存されません
• このコードはそのまま Git にコミットしても安全です

サーバーの拡張

この MCP サーバーは、次の方法で拡張できます。

1. ほかの OKX API エンドポイント用のツールを追加する
2. API キーを使った認証が必要なエンドポイントを実装する
3. ほかの取引所への対応を追加する
4. より複雑なチャートを使って可視化をさらに強化する
5. テクニカル分析インジケーター（RSI、MACD、移動平均線）を追加する
6. 複数の暗号資産を対象とする価格比較ツールを実装する
7. より広範な市場分析のための市場サマリー機能を追加する

ライセンス

MIT