XTBApiServer

这是一个 MCP 服务器，它使用 @sharplygroup/xtb-api-js 库公开 XTB API。它允许您通过模型上下文协议与您的 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

注意： 将 your_user_id 和 your_password 替换为您实际的 XTB API 凭据。如果您使用的是真实账户，请将 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" 作为传输类型，然后单击 "Connect"。

可用工具

以下工具由此 MCP 服务器公开：

账户操作

• getCurrentUserData: 返回有关账户货币和账户杠杆的信息。
• getMarginLevel: 返回各种账户指标。

计算操作

• getCommissionDef: 返回佣金和汇率的计算结果。
  • 参数：symbol (字符串), volume (数字)
• getMarginTrade: 返回给定工具和交易量的预期保证金。
  • 参数：symbol (字符串), volume (数字)
• getProfitCalculation: 计算给定交易数据的估计利润。
  • 参数：closePrice (数字), cmd (数字), openPrice (数字), symbol (字符串), volume (数字)

市场数据操作

• getCalendar: 返回包含市场事件的日历。
• getChartLastRequest: 返回图表信息，从开始日期到当前时间。
  • 参数：info (任意类型)
• getChartRangeRequest: 返回具有给定开始和结束日期之间数据的图表信息。
  • 参数：info (任意类型)
• getTickPrices: 返回给定代码的当前报价数组，仅返回自给定时间戳以来已更改的报价。
  • 参数：level (数字), symbols (字符串数组), timestamp (数字)
• getTradingHours: 返回报价和交易时间。
  • 参数：symbols (字符串数组)

新闻操作

• getNews: 返回在指定时间段内从交易服务器发送的新闻。
  • 参数：end (数字), start (数字)

服务器操作

• getServerTime: 返回交易服务器上的当前时间。
• getVersion: 返回当前的 API 版本。
• ping: 定期调用此函数足以刷新系统中所有组件的内部状态。

代码操作

• getAllSymbols: 返回用户可用的所有代码的数组。
• getSymbol: 返回有关用户可用的代码的信息。
  • 参数：symbol (字符串)

交易操作

• getTrades: 返回用户的交易数组。
  • 参数：openedOnly (布尔值)
• getTradeRecords: 返回 orders 参数中列出的交易数组。
  • 参数：orders (数字数组)
• getTradesHistory: 返回在指定时间段内平仓的用户交易数组。
  • 参数：end (数字), start (数字)
• getTradeStatus: 返回当前交易状态。
  • 参数：order (数字)

交易操作

• tradeTransaction: 启动交易事务。
  • 参数：tradeTransInfo (任意类型)
• tradeTransactionStatus: 返回当前交易状态。
  • 参数：order (数字)

命令执行

• executeCommand: 在服务器上执行命令。
  • 参数：command (字符串)

提示

以下提示可用：

• getAccountDataPrompt: 获取当前账户数据。
• getSymbolInfoPrompt: 获取有关特定代码的信息。
  • 参数：symbol (字符串)

免责声明

此 MCP 服务器作为示例提供，您应自行承担使用风险。在使用此服务器与真实交易账户之前，请确保您了解 XTB API 以及涉及的潜在风险。