etoro-mcp

Удалённый MCP-сервер только для чтения, который предоставляет данные портфеля eToro (позиции, P&L, балансы, watchlist-списки, историю закрытых сделок) в виде инструментов, чтобы его можно было зарегистрировать как пользовательский коннектор в Claude (в чате claude.ai, а не только в редакторе). Работает на Cloudflare Workers поверх Streamable HTTP.

Это личный инструмент для одного пользователя. Он никогда не открывает, не изменяет и не закрывает сделки — только GET-запросы к API eToro.

Предварительные требования

• Node.js (актуальная LTS)

• Учётная запись Cloudflare (для wrangler dev и последующего развёртывания)

• Учётные данные eToro API (x-api-key / x-user-key) с api-portal.etoro.com

Установите зависимости:

npm install

О Wrangler

Этот проект развёртывается на Cloudflare Workers, а Wrangler — официальный CLI Cloudflare для сборки, тестирования и развёртывания Workers. Он уже указан как devDependency, поэтому npm install сам подтянет его — отдельная установка не нужна. Используется через npx wrangler ... или скрипт npm run dev ниже. Соответствующие команды:

• wrangler dev — запускает сервер локально, имитируя среду Workers (именно это вызывает npm run dev).

• wrangler deploy — публикует код в Edge-сети Cloudflare по реальному публичному URL.

• wrangler secret put <NAME> — безопасно загружает секрет (например, ваш API-ключ eToro или bearer-токен коннектора) в развёрнутый 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 — секретный bearer-токен, защищающий собственную конечную точку /mcp этого коннектора (не связан с учётными данными eToro выше). Сгенерируйте его командой:

     openssl rand -hex 32

   .dev.vars игнорируется git — никогда не фиксируЙте его в репозитории.

3. Запустите локальный dev-сервер Workers:

   npm run dev

4. Каждый запрос к /mcp должен содержать bearer-токен:

   Authorization: Bearer <CONNECTOR_AUTH_TOKEN from .dev.vars>

   Запросы без этого заголовка или с неверным токеном получают 401. Если CONNECTOR_AUTH_TOKEN вообще не задан, сервер закрываетвсе запросы и отклоняет их, не допуская неавторизованного доступа.

Запуск тестов

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

Развёртывание и регистрация в качестве коннектора Claude

Развёртывание и регистрация коннектора — ручные шаги, которые выполняет оператор (не являются частью автоматизации этого репозитория):

1. Задайте секреты на развёрнутом Worker (никогда не фиксируйте их в репозитории):

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

2. Разверните:

   wrangler deploy

   Это публикует Worker и выводит его URL вида *.workers.dev (или пользовательский маршрут, если он настроен).

3. Зарегистрируйте его как пользовательский коннектор в Claude:

   • В claude.ai перейдите в Settings → Connectors → Add custom connector.

   • Введите URL развёрнутого Worker с путём /mcp.

   • Выполните шаг аутентификации коннектора, указав то же самое CONNECTOR_AUTH_TOKEN, которое было задано через wrangler secret put выше.

4. Сквозная проверка: задайте Claude в обычном чате реальный вопрос о портфеле (например, «какой у меня сейчас P&L по портфелю eToro?») и убедитесь, что он вызывает правильный нужный инструмент и возвращает живые данные.