Deriv

🚀 Deriv API 服務器

Deriv API 服務器是一個基於模型上下文協議（MCP）的服務器，同時提供 OpenAI 函數調用服務，可用於與 Deriv API 進行交互，為用戶提供便捷的交易信息查詢功能。

✨ 主要特性

• 獲取活躍交易符號列表
• 查詢賬戶餘額

📦 安裝指南

本地安裝

curl -LsSf https://astral.sh/uv/install.sh | sh

Docker 安裝

1. 構建 Docker 鏡像：

docker build -t deriv-api-mcp .

🔧 環境配置

在項目根目錄下創建一個 .env 文件：

DERIV_API_TOKEN=你的_api_密鑰_此處

🚀 快速開始

Claude Desktop 完全支持 MCP 功能特性。要使用此服務器，請執行以下步驟：

1. 下載並安裝 Claude Desktop
2. 將其添加到您的 Claude Desktop 配置中：
   • 對於 macOS 用戶：~/Library/Application Support/Claude/claude_desktop_config.json
   • 對於 VSCode 用戶（Windows）：C:\Users\當前用戶\AppData\Local\Claude\claude_desktop_config.json

適用於本地安裝

{
  "mcpServers": {
    "deriv-api-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/Users/raju/Sites/deriv/mcp-deriv-api-server",
        "run",
        "server.py"
      ]
    }
  }
}

適用於 Docker 安裝

{
  "mcpServers": {
    "deriv-api-mcp": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "deriv-api-mcp"
      ]
    }
  }
}

3. 重啟 Claude Desktop

該服務器提供以下工具：

• get_active_symbols：獲取活躍交易符號列表
• get_account_balance：查詢當前賬戶餘額

💻 使用示例

基礎用法

若要使用服務器提供的工具，可參考以下示例：

# 假設存在一個調用服務器工具的函數
# 調用 get_active_symbols 獲取活躍交易符號列表
active_symbols = call_server_tool('get_active_symbols')
print(active_symbols)

# 調用 get_account_balance 查詢當前賬戶餘額
account_balance = call_server_tool('get_account_balance')
print(account_balance)

高級用法

在實際應用中，可結合業務邏輯使用服務器工具：

# 先獲取活躍交易符號列表
active_symbols = call_server_tool('get_active_symbols')

# 篩選出特定類型的交易符號
specific_symbols = [symbol for symbol in active_symbols if '特定類型' in symbol]

# 查詢賬戶餘額，根據餘額決定是否對特定交易符號進行操作
account_balance = call_server_tool('get_account_balance')
if account_balance > 一定金額:
    # 執行相關操作
    perform_operation(specific_symbols)

📚 詳細文檔

請參考 Deriv API 文檔 獲取最新的速率限制和使用說明。

📄 許可證

本項目採用 MIT 許可證。