eToro-mcp

只读远程 MCP 服务器，将 eToro 投资组合数据（持仓、盈亏、余额、自选列表、已平仓交易历史）以工具形式暴露，因此可以注册为 Claude 中的自定义连接器（用于 claude.ai 聊天，而不只是编辑器）。它基于 Streamable HTTP 运行在 Cloudflare Workers 上。

这是个人、单用户工具。它绝不会开仓、修改或平仓——只对 eToro API 发出 GET 请求。

前置条件

• Node.js（近期 LTS）

• 一个用于部署应用的 Cloudflare 账户（供 wrangler dev 和日后部署使用）

• 来自 api-portal.etoro.com 的 eToro API 凭据（x-api-key / x-user-key）

安装依赖：

npm install

关于 Wrangler

本项目部署到 Cloudflare Workers，而 Wrangler 是 Cloudflare 官方用于构建、测试和部署 Workers 的 CLI。它已被列为 devDependency，所以 npm install 会自动安装——无需单独安装。可通过 npx wrangler ... 或下方的 npm run dev 脚本使用。相关命令：

• wrangler dev — 在本地运行服务器，模拟 Workers 运行时（npm run dev 调用的正是此命令）。

• wrangler deploy — 将代码发布到 Cloudflare 边缘网络，生成真实的公共 URL。

• wrangler secret put <NAME> — 将机密（例如你的 etoro API key 或连接器的 bearer token）安全上传到已部署的 Worker，且绝不会提交到仓库。

• wrangler.toml — 本仓库的 Workers 配置（build/name/routes）。

在 wrangler deploy 或 wrangler secret put 生效之前，请先登录一次：

wrangler login

Related MCP server: eToro Portfolio Connector

本地开发（wrangler dev）

1. 复制示例环境文件并填写真实值：

   cp .dev.vars.example .dev.vars

2. 在 .dev.vars 中设置：

   • ETORO_API_KEY / ETORO_USER_KEY — 你的 eToro API 凭据。

   • CONNECTOR_AUTH_TOKEN — 一个用于保护本连接器的 /mcp 端点的 secret bearer token（与上面的 eToro 凭据无关）。可用以下命令生成：

     openssl rand -hex 32

   .dev.vars 已被 gitignore——切勿提交。

3. 启动本地 Workers 开发服务器：

   npm run dev

4. 每个指向 /mcp 的请求都必须携带 bearer token：

   Authorization: Bearer <CONNECTOR_AUTH_TOKEN from .dev.vars>

   缺少该头部，或携带错误 token 的请求，会收到 401。如果 CONNECTOR_AUTH_TOKEN 完全没有设置，服务器会按 fail-closed（默认拒绝）机制运作，拒绝所有请求，而不会允许未认证访问。

运行测试

npm test        # unit tests (node:test)
npm run typecheck

部署并注册为 Claude 连接器

部署和连接器注册均须手动完成，由操作者执行（不属于本仓库自动化的一部分）：

1. 在已部署的 Worker 上设置 secrets（绝不能提交到仓库）：

   wrangler secret put ETORO_API_KEY
   wrangler secret put ETORO_USER_KEY
   wrangler secret put CONNECTOR_AUTH_TOKEN

2. 部署：

   wrangler deploy

   这会发布当前 Worker，并打印其 *.workers.dev URL（或自定义路由，如已配置）。

3. 注册为 Claude 中的自定义连接器：

   • 在 claude.ai 中，进入 Settings → Connectors → Add custom connector。

   • 输入已部署 Worker 的 /mcp URL。

   • 完成连接器的认证步骤，提供与上面通过 wrangler secret put 设置的同一个 CONNECTOR_AUTH_TOKEN 值。

4. 端到端检查： 在普通聊天中向 Claude 提一个真实的投资组合问题（例如“我现在知道的 etoro 投资组合盈亏是多少？”），并确认它调用了正确的工具且返回实时数据。