eToro MCP Server

eToro MCP 服务

---

概览

此 MCP 服务封装了 eToro 公共 API，为 AI 助手（Claude Desktop、Cursor、Claude Code 等）提供 35 个工具。专为投资研究和投资组合分析打造，可评估持仓、研究金融工具和主题、审核适合跟单交易的热门投资者，并基于历史数据回测定期定额投资（DCA）策略。服务全面支持交易，但请谨慎使用：让 AI Agent 下达真实资金订单确实有风险，应当认真对待。

你可以用它做什么？

此服务首先围绕研究工作流构建。以下示例展示了真实的多工具对话：助手将多个 etoro_* 调用串联起来，回答一个问题。数字仅供参考；实际响应使用 eToro 实时数据。

1. 投资组合健康检查

助手调用 etoro_get_portfolio 获取你的未平仓持仓，然后调用 etoro_get_instruments 将金融工具 ID 对应到名称和行业，再调用 etoro_get_rates 获取实时价格。它会根据原始数据整理出完整概览。

你： 我的投资组合表现如何？按行业细分，并标出任何风险点。

助手： 我已获取你的投资组合（98 个未平仓持仓），解析了每种金融工具，并获取了实时汇率。情况如下：

• 现金： $22,265 • 已投资： $45,782 • 持仓： 98 个未平仓

行业分布：

行业	占已投资比例	主要持仓
科技	38%	GOOG、META、MSFT、NVDA、AMZN
ETF 与指数	22%	VOO、QQQ、SOXX、ARGT、IEUR
加密货币	15%	BTC、ETH
医疗保健	10%	UNH
金融	8%	SAP
其他	7%	LDO 等

风险点： 科技板块占已投资资金的 38%，且集中在 5 家大型市值公司。单一行业下跌会造成显著冲击——请考虑 ETF 重叠（QQQ、SOXX）是有意分散投资，还是无意中重复加仓。

使用的工具： etoro_get_portfolio → etoro_get_instruments → etoro_get_rates

---

2. 研究工具

搜索基于关键词——etoro_search_instruments 会按股票代码或公司名称查找工具，然后你可以接着调用 etoro_get_instruments 获取完整详情，并调用 etoro_get_candles 查询价格历史。

你： 查一下 NVDA——我想看当前价格和过去一个月的周线图。

助手： 正在搜索“NVDA”并获取蜡烛图数据：

• NVIDIA Corporation（NVDA）— InstrumentID 1545
• 实时价格： 买价 $208.14 / 卖价 $208.40
• 交易所： NASDAQ • 类型： 股票 • 行业： 半导体

过去 5 周的周线蜡烛图：

周起始日	开盘价	最高价	最低价	收盘价
Mar 22	$172.65	$181.20	$167.01	$167.61
Mar 29	$165.26	$177.47	$162.95	$176.72
Apr 5	$176.12	$189.98	$173.66	$188.53
Apr 12	$184.15	$201.69	$183.98	$201.64
Apr 19	$199.02	$210.92	$197.23	$208.26

NVDA 从 3 月低点上涨了 27%（$162.95 → $208.26），每根周线蜡烛都创出更高的低点。动能强劲，但这波涨势已显得有些过度延伸。

使用的工具： etoro_search_instruments → etoro_get_instruments → etoro_get_rates → etoro_get_candles

---

3. 跟单投资尽职调查

利用真实公开数据评估热门投资者。助手会调用 etoro_get_user_profile 获取身份信息和统计数据，然后调用 etoro_get_user_performance 获取完整的年度回报历史。

你： 评估一下用户 jeppekirkbonde 是否适合长期跟单配置。我想了解真实的风险情况。

助手： 以下是 jeppekirkbonde 的数据：

• 姓名： Jeppe Kirk Bonde • PI 等级： 6（最高级别）
• 跟单者： 25,000+ • 管理资产： $200M+
• 背景： 哥本哈根商学院金融学硕士

逐年表现（真实数据）：

年份	回报率		年份	回报率
2013	+8.9%		2020	+36.9%
2014	−14.3%		2021	+15.9%
2015	+22.4%		2022	−19.2%
2016	+81.1%		2023	+23.9%
2017	+150.9%		2024	+21.0%
2018	−10.9%		2025	+37.7%
2019	+45.1%

年均回报率： 13 个完整年度平均为 +30.7%。有 3 个下跌年份（2014、2018、2022），2022 年科技股抛售期间的最大回撤为 −19.2%。

你需要了解的事项：

1. 这是一种集中投资、仅做多的美国科技股策略。2017 年的 +150.9% 和 2016 年的 +81.1% 都是异常高值——不要指望每年都能达到这种表现。
2. 下跌年份确实存在：2022 年亏损了 −19.2%。如果你无法承受账面亏损 20%，这不适合你跟单。
3. 25K+ 跟单者和 $200M+ 管理资产意味着其交易会对规模较小的股票产生市场影响。滑点是需要考虑的因素。

如果你能接受波动，这适合多年期资金配置。不适合 18 个月内需要用到的资金。

使用的工具： etoro_get_user_profile → etoro_get_user_performance

---

4. 自选列表管理

通过自然语言完成自选列表的整个生命周期——创建、填充、重命名和整理。

你： 创建一个名为「Semiconductor」的自选列表，并将 NVDA、AMD、ASML、TSM 和 AVGO 添加到其中。

助手： 完成：

1. 已创建自选列表 「Semiconductor」（ID：48291）
2. 已搜索并将全部 5 个股票代码解析为工具 ID
3. 已添加：NVDA (1545)、AMD (2842)、ASML (5765)、TSM (3901)、AVGO (6192)

当前自选列表：

自选列表	项目数
Recently Invested	38
My Watchlist	34
Stocks pre-screening	69
ETFs	54
Semiconductor ← 新建	5
People & Smart Portfolios	26
Crypto	6
Commodities	5

使用的工具： etoro_create_watchlist → etoro_search_instruments → etoro_add_watchlist_items → etoro_get_watchlists

---

5. 使用历史 K 线回测定期定额投资

使用 etoro_get_candles 获取多年的 OHLCV 数据，然后模拟定期定额投资策略——不会下单，纯粹用于研究。

你： 回测过去 3 年每月向 QQQ 定投 $500。现在我会有多少？

助手： 正在提取 QQQ 的周线 K 线（156 周），并模拟每月第一个交易日投入 $500：

• 总投入： $18,000（36 个月 × $500）
• 累计份额： 约 38.2 QQQ
• 当前价值： $25,365（按每股 $664.01 计算）
• 收益： +$7,365（相当于投入资金的 +40.9%）
• 约计年化内部收益率： 约 12.8%/年

最艰难的一段： 2022 年 11 月至 2023 年 3 月，累计持仓曾账面回撤 22%。你坚持买入，低价购入的份额如今成了你收益最高的部分。

未下任何订单。此内容仅供研究。

使用的工具： etoro_get_candles → etoro_get_rates（获取当前价格）

---

6. 结合宏观因素审视投资组合

将投资组合数据与助手的通用知识结合起来，评估与你的实际持仓相关的风险。

你： 我的投资组合重仓科技股。请指出本周宏观经济日程中有哪些风险。

助手： 你的科技股敞口总计约为 17,400 美元（占已投资资金的 38%），涉及 GOOG、META、MSFT、NVDA、AMZN 以及 SOXX/QQQ ETF。本周值得关注的事项：

• 周三 — CPI 数据公布（核心 CPI 市场预期环比上涨 0.3%）。若数据高于预期，降息概率将重新定价 → 科技股估值倍数率先承压。
• 周四 — 美联储官员发表讲话（Williams、Waller）。鹰派言论会推高美元，令大型科技公司的国际营收承压。
• 周五 — NVDA 财报（收盘后）。这是你最大的单只股票持仓面临的二元事件。

对你的影响：

• CPI 数据偏热且美联储立场鹰派，可能导致你的科技股仓位短期下跌 3–5%。
• NVDA 财报将左右你投资组合约 8% 的周环比变动。财报公布前，请先明确你的投资逻辑。

使用的工具： etoro_get_portfolio → etoro_get_instruments → etoro_get_rates（以及助手的宏观知识）

---

也支持交易 — 示例

⚠️ 让 AI 执行真实资金交易存在风险。 自然语言界面能加快研究，也可能让意图很容易被误解——比如打错字、数字含义模糊，或沿用对话前文中过时的上下文。降低风险的做法：先使用 ETORO_TRADING_MODE=demo，对不需要写入权限的操作使用只读 API 密钥，并要求助手在下达任何 real 订单前先征得你的明确确认。

以上示例仅用于研究。准备好交易时，同一界面也可以下单。订单始终遵循配置的 ETORO_TRADING_MODE（模拟交易使用 demo，实盘交易使用 real）。

你： 以市价买入 500 美元的 NVDA。

助手： 已确认 — 正在开立市价仓位：

• 工具： NVDA (1545)
• 金额： 500 美元
• 价格： 208.40 美元（卖价）
• 模式： demo

仓位已开立 — ID 3418072。这是模拟交易，不涉及真实资金。

完整的交易功能包括：按金额或单位开立仓位（etoro_open_position）、平仓或部分平仓（etoro_close_position）、限价单/入场订单（etoro_place_limit_order）、取消待处理订单（etoro_cancel_order）以及列出待处理订单（etoro_get_orders）。

---

与其他 MCP 服务组合使用

MCP 服务专为组合使用而设计。eToro 服务负责处理投资组合数据、实时价格、K 线和交易，但 AI 助手可以在同一次对话中调用多个服务的工具，弥补单个 API 无法覆盖的功能缺口。

示例：跨两个服务检查财报风险

搭配 eToro 和金融数据服务（例如 Financial Datasets、Alpha Vantage 或类似服务）：

你： 我有哪些未平仓位本周会发布财报？请指出我需要关注的持仓。

助手： 正在从 eToro 拉取你的投资组合（98 个仓位），然后查看财报日历：

• NVDA — 周四收盘后发布财报。你的持仓：4,200 美元（已投资资金的 9.2%）。这是一个二元事件，预计股价波动 ±8%。
• GOOGL — 周二收盘后发布财报。你的持仓：3,100 美元（6.8%）。市场预期营收同比增长 12%；广告营收占比是关键变量。
• UNH — 周一盘前已发布财报（影响已计入股价）。EPS 超预期，会员增长略低于预期。

你的其他持仓本周均无财报。最大的事件风险是周四的 NVDA 财报——它是你最大的单只股票持仓。

仅使用 eToro 服务无法做到这一点——它知道你的持仓，却不知道财报日历。金融数据服务知道财报日历，却不知道你的投资组合。两者结合后，助手便能将两边的信息联系起来。

自然搭配

搭配对象	提供的功能	工作流示例
研究与评级（Morningstar）	分析师研究、公允价值估算、护城河评级、基金数据	“Morningstar 对我持有的科技股给出的公允价值是多少？”——获取投资组合，查询评级
新闻与网页搜索（Brave Search、Tavily）	突发新闻、情绪、事件背景	“今天有什么关于我持仓的新闻吗？”——获取投资组合，逐一搜索每只股票
金融数据（Financial Datasets、Alpha Vantage）	基本面、财报、SEC 文件、经济日历	“给我看看科技股持仓的市盈率”——获取持仓，查询基本面数据
市场数据（Polygon.io、Twelve Data、Massive）	实时流式数据、期权链、筛选器标的范围	“筛选 S&P 500，找出动量交易机会，然后将排名前 5 的股票加入我的自选列表”
免费替代方案（Yahoo Finance）	价格、财务数据、期权、市场新闻（无需 API 密钥）	“比较 NVDA 和 AMD 过去 4 个季度的盈利增长”

配置

只需将多个服务添加到 MCP 配置中，助手就能看到所有服务提供的工具：

{
  "mcpServers": {
    "etoro": {
      "command": "npx",
      "args": ["-y", "etoro-mcp-server"],
      "env": {
        "ETORO_API_KEY": "your-api-key",
        "ETORO_USER_KEY": "your-user-key",
        "ETORO_TRADING_MODE": "demo"
      }
    },
    "financial-data": {
      "command": "npx",
      "args": ["-y", "financial-datasets-mcp-server"],
      "env": {
        "FINANCIAL_DATASETS_API_KEY": "your-key"
      }
    },
    "news": {
      "command": "npx",
      "args": ["-y", "tavily-mcp-server"],
      "env": {
        "TAVILY_API_KEY": "your-key"
      }
    }
  }
}

如果问题需要，助手会自动串联不同服务中的工具，无需额外配置。

---

安装

Claude Desktop（推荐）

从 Releases 页面下载最新的 .mcpb 文件，然后将其拖到 Claude Desktop 中：

扩展 → 将 etoro-{version}.mcpb 拖入窗口

系统会提示你输入 API Key、User Key 并选择交易模式。就这么简单。

提示

前往 eToro → Settings → Trading → Create New Key 获取密钥。选择环境（Demo 或 Real）以及所需权限（Read 或 Write）。

---

通过 npm（Claude Code、Cursor、Continue、Cody 等）

将以下内容添加到客户端的 MCP 配置中，即可按需从已发布的 npm 包启动服务，无需本地安装：

{
  "mcpServers": {
    "etoro": {
      "command": "npx",
      "args": ["-y", "etoro-mcp-server"],
      "env": {
        "ETORO_API_KEY": "your-api-key",
        "ETORO_USER_KEY": "your-user-key",
        "ETORO_TRADING_MODE": "demo"
      }
    }
  }
}

对于 Claude Code，可使用等效的 CLI 命令：

claude mcp add etoro \
  -e ETORO_API_KEY=your-api-key \
  -e ETORO_USER_KEY=your-user-key \
  -e ETORO_TRADING_MODE=demo \
  -- npx -y etoro-mcp-server

如果你更看重稳定性而非自动更新，可在参数中使用 [email protected] 固定特定版本。

---

从源代码安装（开发者）

如果想在本地修改服务，请克隆仓库并进行构建：

npm install
npm run build

然后将 MCP 客户端指向构建生成的文件（dist/index.js）：

claude mcp add etoro-mcp \
  -e ETORO_API_KEY=your-api-key \
  -e ETORO_USER_KEY=your-user-key \
  -e ETORO_TRADING_MODE=demo \
  -- node /path/to/etoro-mcp/dist/index.js

或者在 claude_desktop_config.json / 等效文件中配置：

{
  "mcpServers": {
    "etoro-mcp": {
      "command": "node",
      "args": ["/path/to/etoro-mcp/dist/index.js"],
      "env": {
        "ETORO_API_KEY": "your-api-key",
        "ETORO_USER_KEY": "your-user-key",
        "ETORO_TRADING_MODE": "demo"
      }
    }
  }
}

---

MCP Registry

此服务已以 io.github.gabrielcerutti/etoro-mcp-server 的名称列入 MCP Registry。Registry 是 MCP 服务的公开索引——可以将其看作 AI 工具的包注册表，类似于 npm 对 JavaScript 库的作用。兼容 MCP 的客户端可通过它以编程方式发现并安装服务，无需用户手动复制配置。

此仓库的每个已标记版本都会通过 GitHub Actions（使用 OIDC）自动发布到 Registry，因此条目始终对应最新的 npm 版本。

---

配置

设置	环境变量	CLI 参数	默认值
API Key	ETORO_API_KEY	--api-key	（无）
User Key	ETORO_USER_KEY	--user-key	（无）
交易模式	ETORO_TRADING_MODE	--trading-mode	demo

交易模式： demo 会通过 eToro 的虚拟账户处理所有交易调用。只有准备好使用真实资金交易时，才设置为 real。

警告

trading_mode 必须与 API Key 的环境匹配。使用 real 模式搭配 demo Key（或反之）会导致身份验证错误。

---

工具（共 35 个）

所有工具都以 etoro_ 为前缀，以便与其他 MCP 服务组合时隔离命名空间。

市场数据（8 个）

工具	描述
etoro_search_instruments	按关键词（例如“ AAPL”“Bitcoin”）或精确代码搜索投资品种
etoro_get_instruments	根据 ID 获取完整的投资品种详情（1–100）
etoro_get_instrument_types	列出所有投资品种类型（股票、加密货币、ETF……）
etoro_get_industries	列出行业分类
etoro_get_exchanges	列出证券交易所
etoro_get_candles	获取用于技术分析和回测的 OHLCV 蜡烛图数据
etoro_get_closing_prices	获取历史每日收盘价
etoro_get_rates	获取实时买入价/卖出价

投资组合与交易（7 个）

工具	描述
etoro_get_portfolio	获取投资组合和盈亏：持仓、未实现盈亏、风险敞口摘要、最长持仓时间
etoro_get_orders	列出所有待处理订单（限价/入场）
etoro_get_trade_history	已平仓交易历史（入场/退出、盈亏、持仓时长）。是研究业绩的主要数据来源
etoro_open_position	按 USD 金额或单位开仓（统一工具）
etoro_close_position	完全平掉未平仓头寸，或通过 unitsToDeduct 部分平仓
etoro_place_limit_order	下达限价/入场订单
etoro_cancel_order	取消待处理订单

用户与发现（7 个）

工具	描述
etoro_get_current_user	获取已通过身份验证的用户身份信息（GCID、真实/模拟 CID）
etoro_get_user_profile	获取用户公开资料
etoro_get_user_performance	获取业绩摘要（可按时间段筛选）
etoro_get_user_trades	获取用户在指定时间段内的交易信息
etoro_get_user_portfolio	获取用户当前公开的投资组合持仓
etoro_discover_users	按收益、风险评分和时间段筛选并发现热门投资者
etoro_get_copiers	获取复制你投资组合的用户信息

关注列表（9 个）

工具	描述
etoro_get_watchlists	列出你的关注列表
etoro_create_watchlist	创建关注列表
etoro_delete_watchlist	删除关注列表
etoro_rename_watchlist	重命名关注列表
etoro_add_watchlist_items	向关注列表添加投资品种
etoro_remove_watchlist_item	从关注列表移除投资品种
etoro_set_default_watchlist	设置默认关注列表
etoro_get_curated_lists	获取 eToro 精选列表
etoro_get_public_watchlists	浏览用户的公开关注列表

社交动态（4 个）

工具	描述
etoro_get_instrument_feed	获取某个投资品种的社交动态
etoro_get_user_feed	获取某个用户的社交动态
etoro_create_post	发布社交动态
etoro_create_comment	评论帖子

---

免责声明

本项目是一个非官方的社区集成项目，与 eToro 无关，未获其认可或支持。使用风险由你自行承担。

• 不构成财务建议。 本服务、文档或示例输出中的任何内容均不构成投资建议、推荐，也不构成买卖任何金融工具的要约。
• 你需对自己的交易负责。 配置为 real 模式时，本服务可以下达真实资金订单。确认前请核实每笔订单，并理解 AI 助手可能会误解意图。
• API 变更可能导致服务异常。 本服务依赖 eToro 的公共 API，该 API 可能随时变更，恕不另行通知。在生产环境中务必固定版本。
• 先使用模拟模式。 请先设置 ETORO_TRADING_MODE=demo，只有在确认配置无误后才切换到 real。

---

参与贡献

欢迎贡献——包括错误报告、功能请求和拉取请求。

DeepWiki 页面提供了自动生成的代码库架构概览，可作为深入了解之前的起点。

1. Fork 此仓库，并从 main 创建分支
2. 运行 npm install && npm run build，确认更改可以成功编译
3. 运行 npm test，确保现有测试通过
4. 提交 PR，并清楚说明更改内容及原因

---

许可证

MIT —— 可随意使用、Fork 并在此基础上构建。