Trading212 MCP Server

Trading212 MCP サーバー

概要

この MCP ツールは、エージェント型 AI を Trading212 の証券口座に接続できるようにすることを目的としています。これにより、次のような操作が可能になります。

• AI がポートフォリオを分析し、批評できるようにする
• AI に株式を提案させ、ユーザーに代わって注文する（Trading212 API の制限により、現在、注文を作成できるのは実践モードのみです）
• AI がユーザーに代わって Trading212 の投資パイを管理・更新できるようにする
• AI がユーザーに代わって Trading212 の投資パイを作成できるようにする（近日公開）

Trading212 API には厳しいレート制限があるため、このツールは API の結果をメモリ内にキャッシュしようとします（デフォルトの TTL は 5 分です）。

ポート 6379 でローカルの Redis サーバーを起動すると、このツールはメモリ内キャッシュの代わりに Redis を使用します。

セキュリティに関するヒント

• ツールサーバーをリモートでホストし、インターネット経由で接続する場合は、HTTPS を使用するリバースプロキシを導入してください。相互 TLS 認証を実施するのが望ましいです。
• Trading212 API キーを平文で保存しないようにしてください。keyring や 1password などの自動シークレットマネージャーの使用をお勧めします。
• 実際の口座に接続する前に、必ずデモ口座でコネクターをテストしてください。

コンポーネント

リソース

サーバーは次の動的リソースを公開します。

• trading212://equity/portfolio：マイポートフォリオ — 取引ポートフォリオ内のすべての資産
• trading212://equity/account/info — マイアカウント情報 — 取引口座に関する情報
• trading212://equity/account/cash — マイキャッシュ — 取引口座で利用可能な現金に関する情報
• trading212://equity/metadata/instruments/all — 取引対象の金融商品情報 — すべての金融商品に関する情報（警告：大量のデータが返され、コンテキストウィンドウを超える可能性があります）
• trading212://equity/metadata/instruments/list — 取引対象の金融商品のティッカー一覧を返します
• trading212://equity/metadata/instruments/{ticker} — 特定のティッカーに関する詳細情報を返します

プロンプト

現在、プロンプトはありません

ツール

サーバーは次のツールを提供します。

注文管理

• place_order

  • 入力に基づいて適切な注文タイプを動的に選択し、Trading212 経由で有効な注文を発注します。
  • 入力：
    • ticker（string）：注文する株式のティッカー
    • quantity（float）：購入または売却する数量
    • stopPrice（float）：ストップ価格（該当する場合）
    • limitPrice（float）：指値価格（該当する場合）
    • validDuration（string）：注文の有効期間（DAY / GTC）
  • 戻り値：Trading212 API のデータオブジェクト

• cancel_order（近日公開）

  • Trading212 経由で注文をキャンセルします
  • 入力：
    • ticker（string）：注文のティッカー
  • 戻り値：Trading212 API のデータオブジェクト

• create_pie（近日公開）

  • Trading212 で「pie」を作成します
  • 入力：
  • dividendCashAction（str）：配当金の処理方法
  • endDate（str）：pie の目標終了日
  • goal（int）：pie の貯蓄目標
  • icon（str）：pie に使用するアイコン
  • instrumentShares（dict[str, float]）：ティッカー名と株式の配分の対応関係。
  • name（str）：pie の名前
  • 戻り値：Trading212 API のデータオブジェクト

• update_pie

  • Trading212 の「pie」を更新します
  • 入力：
  • dividendCashAction（str）：配当金の処理方法
  • endDate（str）：pie の目標終了日
  • goal（int）：pie の貯蓄目標
  • icon（str）：pie に使用するアイコン
  • instrumentShares（dict[str, float]）：ティッカー名と株式の配分の対応関係。
  • name（str）：pie の名前
  • 戻り値：Trading212 API のデータオブジェクト

アカウントデータ

• get_account_info

  • アカウント ID と通貨を取得します
  • 戻り値：アカウントに関するデータ

• get_portfolio

  • アカウントで現在保有している株式の一覧を取得します
  • 戻り値：ポートフォリオデータ

• get_account_cash

  • アカウントで現在利用可能な現金を取得します
  • 戻り値：残高に関するデータ

市場データ

• get_all_instruments

  • アカウント内のすべての金融商品一覧を取得します（警告：大量のデータが返されます）
  • 戻り値：すべての株式に関する完全なデータ

• get_instrument_list

  • アカウントで利用可能なティッカー一覧を取得します
  • 戻り値：このアカウントで利用可能な株式ティッカーの完全な一覧

• get_instrument

  • ティッカーを指定して、取引対象の金融商品 1 件に関する完全な情報を取得します
  • 入力：
    • ticker（string）：対象のティッカー
  • 戻り値：取引対象の金融商品に関する完全な情報

• search_instruments

  • 部分一致のあいまい検索語を使って、すべての金融商品を名前で検索します
  • 入力：
    • search_term（string）：検索語（通常は企業名）
    • threshold（int）：検索結果に表示するためのあいまい検索スコアの最小値（0～100）、デフォルト：70
    • limit（int）：返す結果の最大数、デフォルト：15
  • 戻り値：一致する金融商品に関する完全な情報

Claude Desktop での使用方法

uv

# Add the server to your claude_desktop_config.json.
# NOTE: To trade in your real account you will need to change --environment to "live"
"mcpServers": {
  "trading212": {
    "command": "uv",
    "args": [
      "--directory",
      "parent_of_servers_repo/servers/src/mcp_server_trading212",
      "run",
      "--api-key",
      "<KEEP_THIS_A_SECRET>",
      "--environment",
      "demo",
      "mcp-server-trading212"
    ]
  }
}

Docker

# Add the server to your claude_desktop_config.json
"mcpServers": {
  "trading212": {
    "command": "docker",
    "args": [
      "run",
      "todo"
    ]
  }
}

SSE モード

このツールには SSE（サーバーサイドイベント）モードが組み込まれています。このモードでは、ツールを HTTP サービスとして実行でき、必要に応じて AI クライアントとは別のサーバーに配置できます。デバッグに便利で、API キーを AI 環境から離れた場所に保管したい場合にも役立ちます。

SSE モードで Claude desktop と使用する

# On Tool server:
uv --directory path/to/project run --api-key '<KEEP_THIS_SECRET>' --environment "demo" mcp-server-trading212 --host 127.0.0.1 --port 6677 --sse

// Claude Desktop file
"mcpServers": {
  "trading212": {
    "command": "uvx",
    "args": [
      "mcp-proxy",
      "http://127.0.0.1:6677/sse",
    ],
    "env": {
        "API_ACCESS_TOKEN": "my-token"
    }
  }
}

Google Gemini CLI での使用方法

要件：

1. Node.js バージョン 20 以降。ダウンロードはこちら（here）[https://nodejs.org/en/download]。
2. gemini-cli。インストール方法の詳細はこちら（here）[https://github.com/google-gemini/gemini-cli] をご覧ください。

gemini-cli はプロジェクトフォルダーのターミナルで実行する必要がある場合があります。

gemini mcp 設定のセットアップ

設定ファイルは、デフォルトでは ~/.gemini/settings.json にあります。

{
  "theme": "Default",
  "selectedAuthType": "oauth-personal",
  "mcpServers": {
    "trading212": {
      "command": "uv", // Path to your uv executable
      "args": [
        "run",                     // uv subcommand
        "--directory",             // uv argument to set working directory
        "absolute/path/to/project/mcp-server-trading212", // Your abosulte path project root
        "mcp-server-trading212"    // The Python module name
      ],
      "env": {
        "TRADING212_API_KEY": "your-trading212-api-key", // Your actual API Key
        "TRADING212_ENVIRONMENT": "demo" // Or "live" if you're using a live account
      }
    }
  }
}

注：uv executable の正しいパスを見つけるには、which uv を使用してください。

信頼できないネットワーク（インターネットなど）経由でツールサーバーに接続する場合は、HTTPS 暗号化を実装したリバースプロキシの背後でツールサーバーをホストしてください。相互 TLS も導入するとよいでしょう。Caddy を使えば、これらすべてを実現できます。

ビルド

Docker：

docker build -t mcp/trading212 .

MCP inspector でテストする

uv add "mcp[cli]"
mcp dev src/mcp_server_sqlite/server.py:wrapper  

ライセンス

この MCP サーバーは MIT License の下でライセンスされています。つまり、MIT License の利用規約に従う限り、ソフトウェアを自由に使用、変更、配布できます。詳しくは、プロジェクトリポジトリの LICENSE ファイルを参照してください。

このコネクターを使用すると、その使用によって生じた金銭的損失に対する補償を含む、MIT ライセンスの条件に同意したものとみなされます。