trading212-mcp-server について
trading212-mcp-serverは、Trading 212の口座をAIアシスタントに接続し、ポートフォリオ照会、取引、投資パイの管理、配当分析を行います。構造化レスポンスとデモ取引に対応しています。
主な機能
- 01口座、現金、保有銘柄の照会
- 02注文の発行と管理
- 03投資パイの作成と編集
- 04運用成績、配当、取引の分析
- 05銘柄検索と記録のエクスポート
活用シーン
- 01ポートフォリオの損益と配分の確認
- 02成行、指値、逆指値注文の発行
- 03銘柄別・月別の配当分析
- 04仮想資金による取引手順のテスト
MCP 対応
MCP サーバーとして、対応クライアントにTrading 212の口座、取引、ポートフォリオ、分析ツールを提供します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
uvx trading212-mcp-serverTRADING212_API_KEYシークレットTrading 212 API key from Settings > API (Beta)TRADING212_API_SECRETシークレットTrading 212 API secret from Settings > API (Beta)ENVIRONMENTAPI environment: 'live' for real account, 'demo' for paper tradingローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
Trading 212 MCP サーバー
AI アシスタントを Trading 212 の証券口座に接続できます。ポートフォリオについて質問したり、取引を発注したり、パイを管理したり、配当を分析したりできます。すべて自然言語で操作できます。
Claude Desktop、Claude Code、ChatGPT、Gemini、Cursor、Windsurf、およびModel Context Protocol(MCP)に対応するすべてのクライアントで動作します。
このサーバーを選ぶ理由
- 32 個のツールで Trading 212 API 全体をカバーし、複数の API 呼び出しを実用的な分析情報にまとめる分析ツールを 4 個追加しています
- スマートなレート制限 — T212 のレート制限ヘッダーを読み取り、自動で待機し、429 の場合は最大 3 回再試行します。AI にレート制限エラーが伝わることはありません
- 設定不要 — PyPI からインストールして API キーを追加すれば完了です。Docker、データベース、Redis は不要です
- 型付きレスポンス — すべてのツールが、生の JSON ではなく構造化された Pydantic モデルを返します
- ペーパートレード —
ENVIRONMENT=demoを設定すると、まず仮想資金でテストできます
何ができますか?
| カテゴリ | ツール | 例 |
|---|---|---|
| 分析 | ポートフォリオの概要、パフォーマンス、配当、取引履歴 | 「ポートフォリオの損益を見せて」 |
| 取引 | 成行注文、指値注文、ストップ注文、ストップリミット注文 | 「AAPL を 5 株買って」 |
| ポートフォリオ | ポジション、現金残高、口座情報 | 「現金残高はいくら?」 |
| パイ | パイの作成、更新、複製、削除 | 「パイの配分を見せて」 |
| 市場データ | 銘柄検索、取引所のスケジュール | 「Tesla を検索して」 |
| 履歴 | 過去の注文、配当、取引、CSV エクスポート | 「配当履歴を見せて」 |
分析ツール
複数の API 呼び出しを、単一の高レベルなレスポンスにまとめます。
fetch_portfolio_summary— 総額、損益、現金、上位保有銘柄、配分を含む完全なスナップショットfetch_portfolio_performance— 配当を含むポジションごとのリターン、最良・最悪のパフォーマンスfetch_dividend_summary— ティッカーと月ごとにまとめた収入分析fetch_recent_activity— 取引と各種トランザクションをまとめたタイムライン
クイックスタート
インストール
uvx trading212-mcp-server
または pip からインストールします。
pip install trading212-mcp-server
API 認証情報を取得する
Trading 212 アプリで、Settings > API (Beta) を開きます。サーバーは Basic Auth を使用するため、API Key と Secret の両方が必要です。
Claude Desktop に接続する
claude_desktop_config.json に追加します(Windows:%APPDATA%\Claude\、Mac:~/Library/Application Support/Claude/)。
{
"mcpServers": {
"trading212": {
"command": "uvx",
"args": ["trading212-mcp-server"],
"env": {
"TRADING212_API_KEY": "<your-api-key>",
"TRADING212_API_SECRET": "<your-api-secret>",
"ENVIRONMENT": "live"
}
}
}
}
Claude Code に接続する
claude mcp add trading212 -- uvx trading212-mcp-server
次に、シェルまたは .env ファイルで環境変数を設定します。
その他のクライアント(Cursor、Windsurf、ChatGPT など)
同じコマンドと環境変数を使用し、クライアントの MCP ドキュメントに従って設定します。ペーパートレードを行うには、ENVIRONMENT を demo に設定します。
ソースからインストールする
git clone https://github.com/KyuRish/trading212-mcp-server.git
cd trading212-mcp-server
cp .env.example .env # fill in your API keys
uv sync
uv run -m trading212_mcp_server.server
ソースからインストールする場合のclaude_desktop_config.json
{
"mcpServers": {
"trading212": {
"command": "uv",
"args": ["run", "--directory", "<path-to-repo>", "-m", "trading212_mcp_server.server"],
"env": {
"TRADING212_API_KEY": "<your-api-key>",
"TRADING212_API_SECRET": "<your-api-secret>",
"ENVIRONMENT": "live"
}
}
}
}
32 個すべてのツール
分析(複合)
| ツール | 説明 |
|---|---|
fetch_portfolio_summary | 損益と配分を含む、ポートフォリオの完全なスナップショット |
fetch_portfolio_performance | ポジションごとのリターン、配当、最良・最悪のパフォーマンス |
fetch_dividend_summary | ティッカーと月ごとの配当収入 |
fetch_recent_activity | 取引と各種トランザクションをまとめたタイムライン |
アカウント
| ツール | 説明 |
|---|---|
fetch_account_info | アカウントのメタデータ(通貨、ID) |
fetch_account_cash | 現金残高、投資額、損益 |
fetch_all_open_positions | リアルタイム価格付きのポートフォリオ全ポジション |
search_specific_position_by_ticker | ティッカーによる単一ポジションの検索 |
取引
| ツール | 説明 |
|---|---|
place_market_order | 現在の市場価格で売買 |
place_limit_order | 指定価格またはそれより有利な価格で売買 |
place_stop_order | ストップ価格で発動する注文 |
place_stop_limit_order | ストップ価格で発動し、指値で執行する注文 |
fetch_all_orders | すべての未約定注文を一覧表示 |
fetch_order | IDで特定の注文を取得 |
cancel_order | 未約定注文をキャンセル |
ポートフォリオ
| ツール | 説明 |
|---|---|
fetch_pies | すべての投資ポートフォリオを一覧表示 |
fetch_a_pie | 銘柄の配分を含むポートフォリオの詳細 |
create_pie | 目標比率を設定して新しいポートフォリオを作成 |
update_pie | ポートフォリオの設定と配分を更新 |
duplicate_pie | 既存のポートフォリオを複製 |
delete_pie | ポートフォリオを削除 |
市場データ
| ツール | 説明 |
|---|---|
search_instrument | ティッカーまたは名称で取引可能な銘柄を検索 |
search_exchange | 利用可能な取引所を検索 |
履歴
| ツール | 説明 |
|---|---|
fetch_historical_order_data | ページネーション対応の過去の注文 |
fetch_paid_out_dividends | 配当金の支払い履歴 |
fetch_transaction_list | 入金と出金 |
fetch_exports_list | CSV エクスポートレポートを一覧表示 |
request_csv_export | 新しい CSV エクスポートをリクエスト |
互換性
以下の MCP クライアントでテスト済みです。
| クライアント | ステータス |
|---|---|
| Claude Desktop | 対応 |
| Claude Code | 対応 |
| Cursor | 対応 |
| Windsurf | 対応 |
| MCP 互換クライアント全般 | 対応 |
作者
Rishabh Dogra が開発しました。
サポート
このサーバーが時間の節約に役立ったら、コーヒーをおごっていただけると大変うれしいです。
ライセンス
MIT
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。