etoro-mcp

読み取り専用のリモート MCP サーバーで、eToro のポートフォリオデータ（ポジション、損益（P&L）、残高、ウォッチリスト、決済済み取引履歴）をツールとして公開し、Claude（claude.ai チャット、エディタだけではない）のカスタムコネクタとして登録できるようにします。Cloudflare Workers 上で Streamable HTTP を介して動作します。

これは個人用のシングルユーザーツールです。取引の発注、変更、クローズは一切行いません。eToro の API に対して GET リクエストのみを送信します。

前提条件

• Node.js（最新の LTS）

• Cloudflare アカウント（wrangler dev と最終的なデプロイ用）

• eToro API の認証情報（x-api-key / x-user-key）— api-portal.etoro.com から取得

依存関係をインストール:

npm install

Wrangler について

このプロジェクトは Cloudflare Workers にデプロイします。Wrangler は Workers のビルド・テスト・デプロイを行う Cloudflare 公式 CLI です。Wrangler はすでに devDependency として登録されているため、npm install でインストールされ、別途インストールは不要です。npx wrangler ... または下記の npm run dev スクリプトから利用します。関連コマンドは次のとおりです:

• wrangler dev — Workers ランタイムをシミュレートしてサーバーをローカルで実行します（このコマンドは npm run dev が呼び出します）。

• wrangler deploy — コードを Cloudflare のエッジに公開し、実際の公開 URL を割り当てます。

• wrangler secret put <NAME> — シークレット（例：eToro API キーやコネクタのベアラートークン）を、リポジトリにコミットすることなく、デプロイされた Worker に安全にアップロードします。

• wrangler.toml — このリポジトリの Workers 設定（build/name/routes）。

wrangler deploy または wrangler secret put を実行する前に、一度ログインしてください:

wrangler login

Related MCP server: eToro Portfolio Connector

ローカル開発（wrangler dev）

1. サンプルの環境変数ファイルをコピーし、実際の値を設定します:

   cp .dev.vars.example .dev.vars

2. .dev.vars に以下を設定します:

   • ETORO_API_KEY / ETORO_USER_KEY — eToro API の認証情報。

   • CONNECTOR_AUTH_TOKEN — このコネクタ自身の /mcp エンドポイントを保護するためのベアラートークン（上記の eToro 認証情報とは無関係）。次のコマンドで生成します:

     openssl rand -hex 32

   .dev.vars は gitignore 対象です。絶対にコミットしないでください。

3. ローカルの Workers 開発サーバーを起動します:

   npm run dev

4. /mcp へのすべてのリクエストにベアラートークンを含める必要があります:

   Authorization: Bearer <CONNECTOR_AUTH_TOKEN from .dev.vars>

   ヘッダーがない、またはトークンが間違っているリクエストには 401 が返ります。CONNECTOR_AUTH_TOKEN がまったく設定されていない場合、サーバーはフェイルクローズ（fail closed）として動作し、未認証アクセスを許可する代わりにすべてのリクエストを拒否します。

テストの実行

npm test        # unit tests (node:test)
npm run typecheck

Claude コネクタとしてのデプロイと登録

デプロイとコネクタ登録は手動手順で、オペレーターが実施します（このリポジトリの自動処理では実行されません）。

1. デプロイした Worker にシークレットを設定します（リポジトリには決してコミットしない）:

   wrangler secret put ETORO_API_KEY
   wrangler secret put ETORO_USER_KEY
   wrangler secret put CONNECTOR_AUTH_TOKEN

2. デプロイ:

   wrangler deploy

   この Worker が公開され、その *.workers.dev URL（または設定済みのカスタムルート）が表示されます。

3. Claude でカスタムコネクタとして登録:

   • claude.ai で、Settings → Connectors → Add custom connector と操作します。

   • デプロイした Worker の /mcp URL を入力します。

   • コネクタの認証手順を完了し、上記の wrangler secret put で設定した CONNECTOR_AUTH_TOKEN と同じ値を指定します。

4. エンドツーエンドの確認: 通常のチャットで Claude に実際のポートフォリオの質問をします（例：「今の eToro ポートフォリオの損益（P&L）は？」）。正しいツールを呼び出し、実データを返すことを確認します。