Okx MCP Server

🚀 OKX MCP 服務器

本項目搭建了一個 Model Context Protocol (MCP) 服務器，可從 OKX 交易所獲取即時加密貨幣數據。該服務器允許像 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 [倉庫地址]
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

代碼示例

基礎用法

// 獲取比特幣的價格信息
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");

📚 詳細文檔

集成

在 VSCode 中集成

1. 打開 VSCode 並進入 Extensions（擴展）菜單。
2. 搜索並安裝 "Claude" 擴件。
3. 啟動服務器後，打開終端運行 mcp-inspector。

在 Claude Desktop 中集成

1. 下載並安裝 Claude Desktop：下載鏈接
2. 啟動服務器後，在 Claude Desktop 中選擇 "Connect to MCP Server" 並輸入服務器地址。

數據可視化功能

格式選項

• 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