Xtbapiserver Wgv

🚀 XTBApiServer

這是一個藉助 @sharplygroup/xtb-api-js 庫來暴露XTB API的MCP服務器。它能讓您通過Model Context Protocol與自己的XTB交易賬戶進行交互。

🚀 快速開始

先決條件

• Node.js（版本16或更高）
• npm
• 一個XTB交易賬戶

安裝

1. 克隆此倉庫：

git clone [repository_url]

2. 切換到項目目錄：

cd xtb-mcp-server

3. 安裝依賴項：

npm install

配置

1. 在項目目錄中創建一個.env文件，並添加您的XTB API憑證：

DEMO_ACCOUNT=true
USER_ID=your_user_id
PASSWORD=your_password

⚠️ 重要提示

用您的實際XTB API憑證替換 your_user_id 和 your_password。如果您使用的是即時賬戶，請將 DEMO_ACCOUNT 設置為 false。

運行服務器

1. 構建TypeScript代碼：

npm run build

2. 運行服務器：

node build/index.js

與MCP客戶端連接

您可以使用任何MCP客戶端（如MCP Inspector）與此服務器連接。

1. 全局安裝MCP Inspector：

npm install -g @modelcontextprotocol/inspector

2. 使用您的服務器運行MCP Inspector：

npx @modelcontextprotocol/inspector node build/index.js

3. 在MCP Inspector UI中選擇“stdio”作為傳輸類型並點擊“連接”。

✨ 主要特性

此MCP服務器暴露了以下工具：

賬戶操作

• getCurrentUserData：返回有關賬戶貨幣和賬戶槓桿的信息。
• getMarginLevel：返回各種賬戶指標。

計算操作

• getCommissionDef：計算佣金和匯率。
  • 參數：symbol（字符串），volume（數字）
• getMarginTrade：根據給定的工具和數量，返回預期的保證金。
  • 參數：symbol（字符串），volume（數字）
• getProfitCalculation：根據給定的交易數據計算估計利潤。
  • 參數：closePrice（數字），cmd（數字），openPrice（數字），symbol（字符串），volume（數字）

市場數據操作

• getCalendar：返回市場事件日曆。
• getChartLastRequest：返回從開始日期到當前時間的圖表信息。
  • 參數：info（任何）
• getChartRangeRequest：返回指定時間段內的圖表信息。
  • 參數：info（任何）
• getOHLCV：獲取給定工具的開盤價、最高價、最低價和收盤價數據。
  • 參數：symbol（字符串），start（數字），end（數字）

提示

• getSymbolInfoPrompt：獲取特定工具的信息。
  • 參數：symbol（字符串）