etoro-mcp

읽기 전용 원격 MCP 서버로, eToro 포트폴리오 데이터(포지션, 손익(P&L), 자산 잔고, 관심 목록, 청산된 거래 내역)를 도구로 노출합니다. 그래서 Claude의 사용자 지정 커넥터로 등록할 수 있습니다(claude.ai 채팅에서도 사용할 수 있으며 편집기 전용이 아닙니다). Cloudflare Workers에서 Streamable HTTP로 실행됩니다.

이 도구는 개인용, 단일 사용자용입니다. 거래를 체결·수정·청산하지 않으며, 오직 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의 공식 CLI로 Workers를 빌드·테스트·배포합니다. 이미 devDependency로 등록되어 있으므로 npm install만으로 설치되며 별도 설치가 필요하지 않습니다. npx wrangler ... 또는 아래의 npm run dev 스크립트로 사용합니다.

관련 명령어:

• wrangler dev — Workers 런타임을 시뮬레이션하며 서버를 로컬에서 실행합니다(npm run dev가 호출하는 명령입니다).

• wrangler deploy — 코드를 실제 공개 URL로 Cloudflare의 엣지 네트워크에 배포합니다.

• wrangler secret put <NAME> — 비밀값(예: eToro API 키 또는 커넥터 bearer 토큰)을 저장소에 커밋하지 않고 배포된 Worker에 안전하게 업로드합니다.

• wrangler.toml — 이 저장소의 Workers 구성 파일(빌드/이름/라우트)입니다.

wrangler deploy 또는 wrangler secret put이 작동하기 전에 한 번 로그인하세요.

wrangler login

Related MCP server: eToro Portfolio Connector

로컬 개발(wrangler dev)

1. 예제 env 파일을 복사하고 실제 값을 채웁니다.

   cp .dev.vars.example .dev.vars

2. .dev.vars에 다음 설정합니다.

   • ETORO_API_KEY / ETORO_USER_KEY — eToro API 자격 증명입니다.

   • CONNECTOR_AUTH_TOKEN — 이 커넥터의 /mcp 엔드포인트를 보호하는 비밀 bear token입니다(위의 eToro 자격 증명과는 무관합니다). 아래와 같이 생성합니다.

     openssl rand -hex 32

   .dev.vars는 gitignore에 포함되어 있으므로 절대 커밋하지 마세요.

3. 로컬 Workers 개발 서버를 시작합니다.

   npm run dev

4. /mcp에 대한 모든 요청에는 bearer 토큰이 포함되어야 합니다.

   Authorization: Bearer <CONNECTOR_AUTH_TOKEN from .dev.vars>

   헤더가 누락된 요청이나 잘못된 토큰을 사용한 요청은 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에서 사용자 지정 커넥터로 등록:

   • 조안나에서 Settings → Connectors → Add custom connector로 이동합니다.

   • 배포된 Worker의 /mcp URL을 입력합니다.

   • 커넥터 인증 단계를 완료하며, 위에서 wrangler secret put으로 설정한 CONNECTOR_AUTH_TOKEN 값을 그대로 입력합니다.

4. 종단 간 확인: 일반 채팅에서 Claude에게 실제 포트폴리오 관련 질문을 해보세요(예: "지금 내 eToro 포트폴리오 손익은 얼마인가요?"). 올바른 도구를 호출하고 실시간 데이터를 반환하는지 확인합니다.