Etoroportfoliomcp

🚀 eToro MCP Server

このサーバーは、eToroの公開APIエンドポイントとやり取りするためのMCP（Model Context Protocol）ツールを提供します。以下の操作が可能です。

1. ユーザー名を使用してユーザーのポートフォリオを取得する
2. IDで商品の詳細を検索する
3. 商品名の接頭辞で商品を検索する（オートコンプリート）

🚀 クイックスタート

📦 インストール

依存関係をインストールします。

npm install

💻 開発サーバーの起動

npm run dev

🌐 本番用のビルド

npm run build

🚀 本番サーバーの起動

npm start

✨ 主な機能

fetch_etoro_portfolio

eToroユーザーのユーザー名を使用してポートフォリオを取得します。このツールは内部で自動的にユーザー名を顧客ID（CID）に変換します。

パラメーター:

• username: eToroのユーザー名
• authToken (オプション): 認証済みリクエスト用の認証トークン

fetch_instrument_details

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"}'