Etoroportfoliomcp

🚀 eToro MCP 服務器

本服務器提供 MCP（模型上下文協議）工具，用於與 eToro 的公共 API 端點進行交互。它允許你：

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）

⚠️ CORS 限制

請注意，部分 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"}'