Xtb MCP Server

🚀 XTBApiServer

このサーバーは、@sharplygroup/xtb-api-js ライブラリを使用して、XTB APIを公開するMCPサーバーです。モデルコンテキストプロトコルを通じて、XTB取引口座とのやり取りを可能にします。

🚀 クイックスタート

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

✨ 主な機能

• モデルコンテキストプロトコルを通じた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（任意）
• getSymbolInfoPrompt：特定の商品の情報を取得します。

注意事項

このMCPサーバーはサンプルとして提供されており、利用は自己責任で行ってください。このサーバーを実口座で使用する前に、XTB APIとその潜在的なリスクを十分に理解してください。