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