XTBApiServer

基本能力

产品定位

XTBApiServer 是一个金融交易服务，专门用于与 XTB 交易平台进行交互，提供账户管理、市场数据查询、交易执行等功能。

核心功能

1. 账户操作：获取账户信息、保证金水平等。
2. 计算操作：计算佣金、保证金和预期利润。
3. 市场数据操作：获取日历事件、图表数据、实时报价等。
4. 新闻操作：获取指定时间范围内的新闻。
5. 服务器操作：获取服务器时间、API 版本等。
6. 符号操作：获取所有交易符号或特定符号的信息。
7. 交易操作：执行交易、查询交易状态、获取交易历史等。
8. 命令执行：在服务器上执行自定义命令。

适用场景

1. 自动化交易：通过 MCP 客户端自动化执行交易策略。
2. 市场数据分析：实时获取市场数据进行分析。
3. 账户管理：监控账户状态和交易历史。
4. 风险管理：计算保证金和佣金，评估交易风险。

工具列表

1. Account Operations：
2. getCurrentUserData：返回账户货币和杠杆信息。
3. getMarginLevel：返回账户指标。
4. Calculation Operations：
5. getCommissionDef：计算佣金和汇率。
6. getMarginTrade：计算给定工具和交易量的预期保证金。
7. getProfitCalculation：计算给定交易数据的预期利润。
8. Market Data Operations：
9. getCalendar：返回市场事件日历。
10. getChartLastRequest：返回从开始日期到当前时间的图表信息。
11. getChartRangeRequest：返回给定开始和结束日期之间的图表信息。
12. getTickPrices：返回给定符号的当前报价。
13. getTradingHours：返回报价和交易时间。
14. News Operations：
15. getNews：返回指定时间范围内的新闻。
16. Server Operations：
17. getServerTime：返回服务器当前时间。
18. getVersion：返回 API 版本。
19. ping：刷新系统内部状态。
20. Symbol Operations：
21. getAllSymbols：返回所有可用符号。
22. getSymbol：返回特定符号的信息。
23. Trade Operations：
24. getTrades：返回用户的交易列表。
25. getTradeRecords：返回指定订单的交易记录。
26. getTradesHistory：返回指定时间范围内关闭的交易。
27. getTradeStatus：返回当前交易状态。
28. Trading Operations：
29. tradeTransaction：启动交易。
30. tradeTransactionStatus：返回交易状态。
31. Command Execution：
32. executeCommand：在服务器上执行命令。

常见问题解答

1. 如何配置 XTB API 凭证？
2. 在项目目录中创建 .env 文件，并填写 USER_ID 和 PASSWORD。
3. 如何区分演示账户和真实账户？
4. 在 .env 文件中设置 DEMO_ACCOUNT=true 或 DEMO_ACCOUNT=false。
5. 如何连接 MCP 客户端？
6. 使用 MCP Inspector 连接，选择 stdio 作为传输类型。

使用教程

使用依赖

1. Node.js（版本 16 或更高）： bash curl -fsSL https://deb.nodesource.com/setup_16.x | sudo -E bash - sudo apt-get install -y nodejs
2. npm： bash sudo apt-get install npm
3. XTB 交易账户：需自行注册。

安装教程

1. 克隆仓库： bash git clone [repository_url]
2. 进入项目目录： bash cd xtb-mcp-server
3. 安装依赖： bash npm install
4. 配置 .env 文件： DEMO_ACCOUNT=true USER_ID=your_user_id PASSWORD=your_password

调试方式

1. 构建 TypeScript 代码： bash npm run build
2. 运行服务器： bash node build/index.js
3. 使用 MCP Inspector 连接： bash npx @modelcontextprotocol/inspector node build/index.js 在 MCP Inspector UI 中选择 stdio 作为传输类型并点击 "Connect"。

许可证

None