Trading 212 MCP 서버

MCP를 통한 Claude용 안전한 Trading 212 공개 API 액세스

빌드 도구:

프로젝트 개요

이 프로젝트는 Trading 212 공개 API 기능을 MCP 도구로 노출하여 Claude Desktop이 계정, 시장, 주문, 기록 및 파이(Pie) 데이터를 안전하게 조회할 수 있도록 합니다. 사용자 지정 UI를 구축하지 않고도 자연어로 포트폴리오 워크플로우에 액세스하려는 사용자를 대상으로 합니다. 주요 가치는 구조화된 오류, 엄격한 환경 처리 및 도구 우선 MCP 통합을 갖춘 모듈식 기능 기반 TypeScript 아키텍처에 있습니다.

주요 기능

Claude 지원 MCP 도구 - MCP를 통해 Claude Desktop에서 직접 Trading 212 작업을 사용하세요.
공개 API 호환 인증 - API 키 + API 시크릿을 사용하는 Trading 212 기본 인증을 지원합니다.
완벽한 파이(Pie) 지원 - 파이 목록 조회, ID별 가져오기, 생성, 업데이트, 복제 및 삭제 작업을 포함합니다.
주문 워크플로우 포함 - 보류 중인 주문, 주문 세부 정보, 지정가/시장가/스톱/스톱 지정가 주문 실행 및 취소.
기록 + 내보내기 작업 - 커서 기반의 과거 주문, 배당금, 거래 내역 및 CSV 내보내기 요청/목록 엔드포인트.
타입 지정 오류 모델 - 일관된 인증, 유효성 검사, 속도 제한, 찾을 수 없음 및 API 오류 처리.

빠른 시작 데모

로컬에서 실행한 다음 MCP Inspector를 사용하여 도구를 검사하세요:

npx @modelcontextprotocol/inspector

stdio 모드의 경우, Inspector 명령을 다음과 같이 구성하세요:

bun run src/server.ts

기술 스택

언어: TypeScript (strict 모드)
런타임: Bun 1.x (Node.js 18+ 호환)
MCP: @modelcontextprotocol/sdk
유효성 검사/스키마: zod
구성: dotenv
테스트: Bun 테스트 러너 (bun test src)

설치 및 설정

사전 요구 사항

Bun 1.0+
Node.js 18+
Trading 212 공개 API 자격 증명 (TRADING212_API_KEY, TRADING212_API_SECRET)
Claude Desktop (MCP 통합용)

설정

저장소 복제

git clone https://github.com/razeevascx/212mcp.git

프로젝트로 이동
```
cd 212mcp
```
의존성 설치
```
bun install
```
환경 구성
```
cp .env.example .env
```

.env에 자격 증명 설정

TRADING212_API_KEY=your_api_key_here
TRADING212_API_SECRET=your_api_secret_here
ENVIRONMENT=live
TRANSPORT=stdio
LOG_LEVEL=info
DEBUG=false

프로젝트 빌드
```
bun run build
```
서버 시작
```
bun run start
```

확인

터미널 출력에서 Trading 212 MCP Server running을 확인해야 합니다.
Claude Desktop에서 MCP 도구를 열고 Trading 212 도구가 나열되어 있는지 확인하세요.

Claude Desktop 구성

다음 MCP 서버 구성을 사용하세요:

{
  "mcpServers": {
    "trading212": {
      "command": "bun",
      "args": ["run", "src/server.ts"],
      "env": {
        "TRADING212_API_KEY": "your_api_key_here",
        "TRADING212_API_SECRET": "your_api_secret_here"
      }
    }
  }
}

MCP 도구

계정

fetch_account_cash
fetch_account_metadata

상품(Instruments)

search_exchange
search_instrument

포트폴리오 / 포지션

fetch_open_positions
search_specific_position_by_ticker
fetch_open_position_by_ticker

주문

fetch_all_orders
fetch_order
place_limit_order
place_market_order
place_stop_order
place_stop_limit_order
cancel_order

기록

fetch_historical_order_data
fetch_paid_out_dividends
fetch_transaction_list
fetch_exports_list
request_export_csv

파이(Pies)

fetch_pies
fetch_pie
create_pie
update_pie
duplicate_pie
delete_pie

서버 유틸리티

get_server_health

API 사용 참고 사항

인증: Trading 212 공개 API는 BaseClient에서 처리하는 기본 인증(API_KEY:API_SECRET)을 사용합니다.
환경 라우팅: ENVIRONMENT=demo|live는 Trading 212 데모/라이브 기본 URL로 매핑됩니다.
페이지네이션: 기록 엔드포인트는 limit + cursor를 사용하며 nextPagePath를 반환합니다.
속도 제한: API에는 속도 제한이 있으며, 429는 RATE_LIMIT_EXCEEDED로 표시됩니다.

개발

스크립트

bun run build — TypeScript 컴파일
bun run start — MCP 서버 시작
bun run dev — 감시 모드
bun test src — src에서 테스트 실행

문제 해결

자격 증명 누락: TRADING212_API_KEY 및 TRADING212_API_SECRET을 설정하세요.
인증 오류: API 자격 증명을 다시 생성하고 서버를 다시 시작하세요.
Claude 연결 불가: Bun 설치, 명령 경로 및 Claude MCP 구성을 확인하세요.

Trading 212 MCP Server