Xtb MCP Server

🚀 XTBApiServer

這是一個藉助 @sharplygroup/xtb-api-js 庫來暴露XTB API的MCP服務器。它支持您通過模型上下文協議與自己的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（任意）
• getSymbolInfoPrompt：獲取特定工具的信息。

警告

⚠️ 重要提示

此MCP服務器作為一個示例提供，使用時請自擔風險。在將此服務器用於實賬戶之前，請確保您理解XTB API及其潛在風險。