Etoro Portfolio

🚀 eToro MCP 服務器

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）。

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