eToro MCP 服务器

此服务器为与 eToro 的公共 API 端点交互提供 MCP（模型上下文协议）工具。它允许您执行以下操作：

1. 使用用户名获取用户的投资组合
2. 根据 ID 查找交易品种的详细信息
3. 按名称前缀搜索交易品种（自动完成）

快速开始

1. 安装依赖项：

   npm install
   

2. 启动开发服务器：

   npm run dev
   

3. 构建生产环境：

   npm run build
   

4. 启动生产服务器：

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