EtoroPortfolioMCP

🚀 eToro MCP 服务器

本服务器提供了用于与 eToro 公共 API 端点进行交互的 MCP（模型上下文协议）工具。它允许你：

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