Okx MCP Server

🚀 OKX MCP サーバー

このプロジェクトは、OKX 取引所からリアルタイムの暗号通貨データを取得するための Model Context Protocol (MCP) サーバーを作成します。このサーバーは、Claude などの AI アシスタントが定義されたツールを通じて最新の暗号通貨価格情報と履歴データにアクセスできるようにし、強化された視覚化機能と WebSocket を介したリアルタイム更新を提供します。

✨ 主な機能

• get_price：特定の暗号通貨取引ペアの最新価格データを取得し、視覚的に整形します。
• get_candlesticks：履歴ローソク足データを検索し、ASCII グラフを含む複数の視覚化方法をサポートします。
• subscribe_ticker：リアルタイム価格のプッシュ通知を購読します。
• get_live_ticker：アクティブな購読の最新データを取得します。
• unsubscribe_ticker：特定の購読を解除します。

📦 インストール

前提条件

このサーバーを実行するには、以下の環境が必要です。

• Node.js（バージョン 14 以上を推奨）
• npm または yarn
• VSCode と Claude 拡張機能、または Claude Desktop

インストール手順

1. リポジトリをクローンする：

   git clone [リポジトリのURL]
   cd okx-mcp-server
   

2. 依存関係をインストールする：

   npm install
   # または yarn を使用する場合
   yarn install
   

3. WebSocket 依存関係を追加する：

   npm install ws
   # または yarn を使用する場合
   yarn add ws
   

4. プロジェクトをビルドする：

   npm run build
   # または yarn を使用する場合
   yarn build
   

5. 実行権限を付与する（オプション）：

   chmod +x server.js
   

💻 使用例

サーバーを起動する

node server.js
# または yarn を使用する場合
yarn start

MCP Inspector テストツールを使用する

サーバーの機能をテストするには、MCP Inspector を使用できます。

1. MCP Inspector をインストールする：

   npm install -g @okx/mcp-inspector
   

2. Inspector を起動する：

   mcp-inspector
   

統合方法

VSCode での統合

1. VSCode を開き、拡張機能メニューに移動します。
2. "Claude" 拡張機能を検索してインストールします。
3. サーバーを起動した後、ターミナルで mcp-inspector を実行します。

Claude Desktop での統合

1. Claude Desktop をダウンロードしてインストールします：ダウンロードリンク
2. サーバーを起動した後、Claude Desktop で "Connect to MCP Server" を選択し、サーバーのアドレスを入力します。

基本的な使用法

// ビットコインの価格情報を取得する
get_price("BTC-USDT", { format: "markdown" });

// 過去 24 時間のローソク足データを取得する
get_candlesticks("ETH-USDT", { interval: "1h", format: "table" });

高度な使用法

// BTC-USDT のリアルタイム価格更新を購読する
subscribe_ticker("BTC-USDT");

// 最新のリアルタイムデータを取得する
get_live_ticker();

// 購読を解除する
unsubscribe_ticker("BTC-USDT");

データ視覚化機能

フォーマットオプション

• get_price は markdown（デフォルト）または json をサポートします。
• get_candlesticks は markdown（デフォルト）、table または json をサポートします。
• get_live_ticker は markdown（デフォルト）または json をサポートします。

環境変数（オプション）

サーバーを拡張して認証エンドポイントを使用する場合は、以下の環境変数を追加できます。

OKX_API_KEY=your_api_key
OKX_API_SECRET=your_api_secret
OKX_API_PASSPHRASE=your_api_passphrase

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

• 現在の実装では、OKX の公開 API エンドポイントのみを使用しており、API キーは必要ありません。
• コード内には機密データは保存されません。
• このコードを安全に Git リポジトリにコミットできます。

サーバーの拡張

以下の強化機能を検討することができます。

1. 他の OKX API エンドポイントをサポートするためのツールを追加する。
2. API キーを使用して認証が必要なエンドポイントを実装する。
3. 他の暗号通貨取引所をサポートする。
4. 視覚化機能を強化し、複雑なグラフを追加する。
5. 技術指標（RSI、MACD、移動平均線）を統合する。
6. 複数の暗号通貨の価格比較ツールを追加する。
7. 市場の概要機能を実装する。

📄 ライセンス

MIT