🚀 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及其潜在风险。