Trading 212 MCP サーバー

MCP を介した Claude 用の安全な Trading 212 Public API アクセス

使用技術:

プロジェクト概要

このプロジェクトは、Trading 212 Public API の機能を MCP ツールとして公開し、Claude Desktop がアカウント、市場、注文、履歴、およびパイ（Pie）データを安全に照会できるようにします。カスタム UI を構築することなく、自然言語でポートフォリオのワークフローにアクセスしたいユーザーを対象としています。主な価値は、構造化されたエラー、厳密な環境処理、およびツールファーストの MCP 統合を備えた、モジュール式の機能ベースの TypeScript アーキテクチャにあります。

主な機能

Claude 対応 MCP ツール - MCP を通じて Claude Desktop から直接 Trading 212 の操作を実行できます。
Public API 互換認証 - API キーと API シークレットを使用した Trading 212 の基本認証をサポートしています。
完全なパイ（Pie）対応 - パイのリスト取得、ID による取得、作成、更新、複製、削除操作が含まれます。
注文ワークフロー - 未決済注文、注文詳細、指値注文、成行注文、逆指値注文、逆指値指値注文の配置/キャンセルが可能です。
履歴とエクスポート操作 - カーソルベースの注文履歴、配当、取引、および CSV エクスポートのリクエスト/リスト取得エンドポイントを備えています。
型定義されたエラーモデル - 一貫した認証、バリデーション、レート制限、未検出、および API エラー処理を提供します。

クイックスタートデモ

ローカルで実行し、MCP Inspector を使用してツールを検査します：

npx @modelcontextprotocol/inspector

stdio モードの場合、Inspector コマンドを次のように設定します：

bun run src/server.ts

技術スタック

言語: TypeScript (strict モード)
ランタイム: Bun 1.x (Node.js 18+ 互換)
MCP: @modelcontextprotocol/sdk
バリデーション/スキーマ: zod
設定: dotenv
テスト: Bun テストランナー (bun test src)

インストールとセットアップ

前提条件

Bun 1.0+
Node.js 18+
Trading 212 Public API 認証情報 (TRADING212_API_KEY, TRADING212_API_SECRET)
Claude Desktop (MCP 統合用)

セットアップ

リポジトリのクローン

git clone https://github.com/razeevascx/212mcp.git

プロジェクトディレクトリへ移動
```
cd 212mcp
```
依存関係のインストール
```
bun install
```
環境設定
```
cp .env.example .env
```

.env に認証情報を設定

TRADING212_API_KEY=your_api_key_here
TRADING212_API_SECRET=your_api_secret_here
ENVIRONMENT=live
TRANSPORT=stdio
LOG_LEVEL=info
DEBUG=false

プロジェクトのビルド
```
bun run build
```
サーバーの起動
```
bun run start
```

検証

ターミナル出力に Trading 212 MCP Server running と表示されるはずです。
Claude Desktop で MCP ツールを開き、Trading 212 ツールがリストされていることを確認してください。

Claude Desktop の設定

以下の MCP サーバー設定を使用してください：

{
  "mcpServers": {
    "trading212": {
      "command": "bun",
      "args": ["run", "src/server.ts"],
      "env": {
        "TRADING212_API_KEY": "your_api_key_here",
        "TRADING212_API_SECRET": "your_api_secret_here"
      }
    }
  }
}

MCP ツール

アカウント

fetch_account_cash
fetch_account_metadata

銘柄（Instruments）

search_exchange
search_instrument

ポートフォリオ / ポジション

fetch_open_positions
search_specific_position_by_ticker
fetch_open_position_by_ticker

注文

fetch_all_orders
fetch_order
place_limit_order
place_market_order
place_stop_order
place_stop_limit_order
cancel_order

履歴

fetch_historical_order_data
fetch_paid_out_dividends
fetch_transaction_list
fetch_exports_list
request_export_csv

パイ（Pies）

fetch_pies
fetch_pie
create_pie
update_pie
duplicate_pie
delete_pie

サーバーユーティリティ

get_server_health

API 使用上の注意

認証: Trading 212 Public API は基本認証 (API_KEY:API_SECRET) を使用しており、BaseClient によって処理されます。
環境ルーティング: ENVIRONMENT=demo|live は Trading 212 のデモ/ライブベース URL にマッピングされます。
ページネーション: 履歴エンドポイントは limit と cursor を使用し、nextPagePath を返します。
レート制限: API にはレート制限があり、429 は RATE_LIMIT_EXCEEDED として表示されます。

開発

スクリプト

bun run build — TypeScript のコンパイル
bun run start — MCP サーバーの起動
bun run dev — ウォッチモード
bun test src — src 内のテスト実行

トラブルシューティング

認証情報がない: TRADING212_API_KEY と TRADING212_API_SECRET を設定してください。
認証エラー: API 認証情報を再生成し、サーバーを再起動してください。
Claude が接続できない: Bun のインストール、コマンドパス、および Claude MCP 設定を確認してください。

Trading 212 MCP Server