Etoro Portfolio

🚀 eToro MCP サーバー

このサーバーは、eToro のパブリック API エンドポイントとの相互作用に MCP（モデルコンテキストプロトコル）ツールを提供します。以下の操作を実行できます。

1. ユーザー名を使用してユーザーの投資ポートフォリオを取得する
2. ID を基に取引品目の詳細情報を検索する
3. 名前の接頭辞で取引品目を検索する（自動補完）

🚀 クイックスタート

依存関係のインストール

npm install

開発サーバーの起動

npm run dev

本番環境のビルド

npm run build

本番サーバーの起動

npm start

✨ 主な機能

fetch_etoro_portfolio

ユーザー名を使用して eToro ユーザーの投資ポートフォリオを取得します。このツールは自動的にユーザー名をユーザー識別子 (CID) に変換します。

パラメータ:

• username: eToro ユーザー名
• authToken（オプション）: 認証リクエストに使用するトークン

fetch_instrument_details

ID を基に eToro の取引品目の詳細情報を取得します。

パラメータ:

• instrumentIds: 詳細情報を取得する取引品目の ID リスト
• fields（オプション）: レスポンスに含まれるフィールド（デフォルトは displayname、threeMonthPriceChange、oneYearPriceChange、lastYearPriceChange）

search_instruments

名前の接頭辞で eToro の取引品目を検索します（自動補完）。

パラメータ:

• namePrefix: 取引品目名で検索する接頭辞
• fields（オプション）: レスポンスに含まれるフィールド（デフォルトは internalInstrumentId、displayname、internalClosingPrice）

🔧 技術的注意事項

⚠️ 重要提示

一部の eToro API エンドポイントには CORS 制限があり、サーバーサイド環境からのみ呼び出すことができます。このサーバー内のツールは、CORS 問題を回避するためにサーバーサイドでこれらのリクエストを処理します。

💻 使用例

基本的な使用法

このサーバーは REST API を公開しており、任意の HTTP クライアントを使用して呼び出すことができます。

GET /tools                          # 利用可能なすべてのツールをリストする
GET /tools/:name/schema             # ツールのスキーマを取得する
POST /tools/:name/execute           # ツールを実行する

高度な使用法

fetch_etoro_portfolio ツールを使用する例：

curl -X POST http://localhost:3000/tools/fetch_etoro_portfolio/execute \
  -H "Content-Type: application/json" \
  -d '{"username": "yoniasia"}'