MCP Metatrader5 Server

🚀 MetaTrader 5 MCP サーバー

MetaTrader 5 プラットフォーム用の Model Context Protocol (MCP) サーバーです。AI アシスタントが MetaTrader 5 とやり取りし、取引や市場データ分析を行うことを可能にします。

🚀 クイックスタート

MetaTrader 5 MCP サーバーを使用することで、AI アシスタントが MetaTrader 5 と連携し、取引や市場データ分析を行うことができます。以下のセクションでは、サーバーのインストール、使用方法、詳細なドキュメントについて説明します。

✨ 主な機能

• MetaTrader 5 ターミナルに接続する
• 市場データ（シンボル、為替レート、tick データ）にアクセスする
• 注文を出し、取引を管理する
• 取引履歴を分析する
• AI アシスタントがユーザーとやり取りするのをサポートする

📦 インストール

方法 1：PyPI からインストール

pip install mcp-metatrader5-server

方法 2：ソースコードからインストール

1. リポジトリをクローンします：

git clone https://github.com/yourusername/mcp-metatrader5-server.git
cd mcp-metatrader5-server

2. 依存関係をインストールし、パッケージをビルドします：

pip install -r requirements.txt
python -m build

💻 使用例

基本的な使用法

サーバーを起動する

• 開発者モードで起動する：

python -m mcp_metatrader5_server.server --mode dev

• 本番環境で実行する：

python -m mcp_metatrader5_server.server --mode prod

MetaTrader 5 に接続し、市場データを取得する

from mcp_metatrader5_server import MarketData

md = MarketData()
symbol = "EUR_USD"
timeframe = "M15"

data = md.get_data(symbol, timeframe)
print(data)

注文を出し、取引を管理する

from mcp_metatrader5_server import Trading

trading = Trading(account_number="YOUR_ACCOUNT_NUMBER", password="YOUR_PASSWORD")

order_result = trading.open_order(symbol="EUR_USD", order_type="BUY", volume=0.1)
print(order_result)

positions = trading.get_positions()
print(positions)

📚 ドキュメント

リソース

• MetaTrader 5 API ドキュメント
• MCP プロトコルドキュメント

ヒント

• connect_to_mt5(account, password, server): MetaTrader 5 に接続し、ログインする
• analyze_market_data(symbol, timeframe): 指定されたシンボルの市場データを分析する
• place_trade(symbol, order_type, volume): 指定されたシンボルの取引を注文する
• manage_positions(): 未決済のポジションを管理する
• analyze_trading_history(days): 過去の指定日数の取引履歴を分析する

🔧 技術詳細

プロジェクト構造

mcp-metatrader5-server/
├── src/
│   └── mcp_metatrader5_server/
│       ├── __init__.py
│       ├── server.py
│       ├── market_data.py
│       ├── trading.py
│       ├── main.py
│       └── cli.py
├── run.py
├── README.md
└── pyproject.toml

ビルドと公開

1. ビルドツールをインストールする：

pip install build twine

2. パッケージをビルドする：

python -m build

3. PyPI に公開する：

twine upload dist/*

📄 ライセンス

MIT License

謝辞

• MetaQuotes が MetaTrader 5 プラットフォームを提供しています
• FastMCP が MCP サーバーの実装を提供しています