Xtbapiserver Wgv

🚀 XTBApiServer

このサーバーは @sharplygroup/xtb-api-js ライブラリを使用して、XTB APIをModel Context Protocol（MCP）で公開するサーバーです。これにより、MCPを通じてXTB取引口座とやり取りすることができます。

🚀 クイックスタート

XTBApiServerを使用することで、MCPを通じてXTB取引口座とのやり取りが可能になります。以下に、サーバーのセットアップと使用方法を説明します。

✨ 主な機能

• 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
   

   ⚠️ 重要提示

   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」を伝送タイプとして選択し、「接続」をクリックします。

利用可能なツール

この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（文字列）