Interactive Brokers MCP 서버

면책 조항: 본 서버는 비공식 커뮤니티 개발 MCP 서버이며, Interactive Brokers와 제휴하거나 보증하지 않습니다. 이 소프트웨어는 알파 상태이며 완벽하게 작동하지 않을 수 있습니다.

Interactive Brokers 트레이딩 플랫폼과의 통합을 제공하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버를 통해 AI 어시스턴트가 귀하의 IB 계정과 상호작용하여 시장 데이터를 검색하고, 포지션을 확인하며, 주문을 실행할 수 있습니다.

🔒 보안 공지

Related MCP server: Interactive Brokers MCP Server

주요 기능

• Interactive Brokers API 통합: 계정 관리, 포지션 추적, 실시간 시장 데이터, 주문 관리(시장가, 지정가, 스탑 주문)를 포함한 전체 트레이딩 기능 지원

• Flex Query 지원: Flex Query를 실행하여 계정 명세서, 거래 확인서 및 과거 데이터를 검색합니다. 쿼리는 재사용이 쉽도록 자동으로 저장됩니다.

• 유연한 인증: 브라우저 기반 OAuth 인증 또는 자동화된 환경을 위한 자격 증명 기반 헤드리스 모드 중 선택 가능

• 간편한 설정: npx로 직접 실행 가능 - Docker나 추가 설치가 필요 없습니다. 모든 플랫폼을 위한 사전 구성된 IB Gateway 및 Java 런타임이 포함되어 있습니다.

보안 공지

중요 경고:

• 재무적 위험: 트레이딩은 상당한 손실 위험을 수반합니다. 항상 모의 투자(Paper Trading)로 먼저 테스트하십시오.

• 보안: 이 소프트웨어는 민감한 금융 데이터를 처리합니다. 로컬에서만 실행하고, 공용 서버에서는 절대 실행하지 마십시오.

• 보증 없음: 이 비공식 소프트웨어는 어떠한 보증도 제공하지 않습니다. 사용자의 책임하에 사용하십시오.

• 투자 조언 아님: 이 도구는 자동화를 위한 것이며, 투자 조언이 아닙니다.

사전 요구 사항

추가 설치가 필요 없습니다! 이 패키지에는 다음이 포함되어 있습니다:

• 모든 플랫폼(Linux, macOS, Windows)용 사전 구성된 IB Gateway

• IB Gateway용 Java 런타임 환경(JRE), Alpine 기반 컨테이너(예: node:lts-alpine, supergateway)를 위한 musl-libc 빌드 포함

• 모든 필수 종속성

필요한 것:

• Interactive Brokers 계정 (모의 투자 또는 실거래)

• Node.js 18+ (MCP 서버 실행용)

빠른 시작

Cursor/Claude 설정에 이 MCP 서버를 추가하십시오:

{
  "mcpServers": {
    "interactive-brokers": {
      "command": "npx",
      "args": ["-y", "interactive-brokers-mcp"]
    }
  }
}

서버를 처음 사용할 때, Interactive Brokers OAuth 인증 흐름을 위한 웹 브라우저 창이 자동으로 열립니다. IB 자격 증명으로 로그인하여 연결을 승인하십시오.

헤드리스 모드 설정

자동화된 환경이나 인증을 위해 브라우저를 사용하지 않으려는 경우, MCP 서버 설정에서 헤드리스 모드를 구성하여 활성화할 수 있습니다:

{
  "mcpServers": {
    "interactive-brokers": {
      "command": "npx",
      "args": ["-y", "interactive-brokers-mcp"],
      "env": {
        "IB_HEADLESS_MODE": "true",
        "IB_USERNAME": "your_ib_username",
        "IB_PASSWORD_AUTH": "your_ib_password"
      }
    }
  }
}

헤드리스 모드에서는 브라우저 창을 열지 않고도 자격 증명을 사용하여 서버가 자동으로 인증합니다. 이는 다음 상황에 유용합니다:

• 자동화된 트레이딩 시스템

• 디스플레이가 없는 서버 환경

• CI/CD 파이프라인

• 브라우저 상호작용을 원하지 않는 상황

중요: 헤드리스 모드에서도 Interactive Brokers는 2단계 인증(2FA)을 요구할 수 있습니다. 2FA가 트리거되면, 헤드리스 인증은 귀하가 구성한 방법(모바일 앱, SMS 등)을 통해 2FA 프로세스를 완료할 때까지 대기합니다.

모의 투자를 활성화하려면 환경 변수에 "IB_PAPER_TRADING": "true"를 추가하십시오:

{
  "mcpServers": {
    "interactive-brokers": {
      "command": "npx",
      "args": ["-y", "interactive-brokers-mcp"],
      "env": {
        "IB_HEADLESS_MODE": "true",
        "IB_USERNAME": "your_ib_username",
        "IB_PASSWORD_AUTH": "your_ib_password",
        "IB_PAPER_TRADING": "true"
      }
    }
  }
}

보안 참고: 자격 증명을 안전하게 보관하고 버전 관리 시스템에 커밋하지 마십시오. 환경 변수 파일이나 안전한 자격 증명 관리 시스템 사용을 고려하십시오.

Flex Query 설정 (선택 사항)

계정 명세서 및 과거 데이터를 검색하기 위해 Flex Query를 사용하려면 Flex Web Service 토큰을 구성해야 합니다:

{
  "mcpServers": {
    "interactive-brokers": {
      "command": "npx",
      "args": ["-y", "interactive-brokers-mcp"],
      "env": {
        "IB_FLEX_TOKEN": "your_flex_token_here"
      }
    }
  }
}

Flex 토큰을 얻는 방법:

1. Interactive Brokers 계정 관리에 로그인

2. 설정(Settings) → **계정 설정(Account Settings)**으로 이동

3. 보고서(Reporting) → Flex Web Service로 이동

4. Flex Web Service 토큰을 생성하거나 검색

Flex Web Service 활성화에 대한 자세한 지침은 IB Flex Web Service 가이드를 참조하십시오.

Flex Query 생성 방법:

1. 계정 관리에서 보고서(Reports) → **Flex 쿼리(Flex Queries)**로 이동

2. 쿼리 템플릿을 생성하거나 사용자 지정

3. 쿼리 옆의 정보 아이콘을 클릭하여 쿼리 ID 확인

Flex Query 생성 및 사용자 지정에 대한 전체 가이드는 IB Flex 쿼리 가이드를 참조하십시오.

참고: Flex Query를 처음 실행하면 MCP 서버가 API에서 가져온 이름으로 자동으로 저장합니다. 이후 실행 시에는 ID나 저장된 이름으로 쿼리를 참조할 수 있습니다.

Flex Query 기능:

• 자동 메모리: Flex Query를 실행하면 향후 사용을 위해 자동으로 저장됩니다.

• 간편한 재사용: 이전에 사용한 쿼리가 기억되므로 쿼리 ID를 반복해서 복사할 필요가 없습니다.

• 친숙한 이름: 쿼리를 처음 실행할 때 선택적으로 친숙한 이름을 제공할 수 있습니다.

• 쿼리 삭제: forget_flex_query 도구로 더 이상 필요 없는 쿼리를 제거할 수 있습니다.

설정 변수

사용 가능한 MCP 도구

트레이딩 및 계정 관리

Flex 쿼리 (IB_FLEX_TOKEN 필요)

문제 해결

인증 문제:

• 자동으로 열리는 웹 인터페이스를 사용하십시오.

• 필요한 2단계 인증을 완료하십시오.

• 실거래가 실패하면 모의 투자 모드를 시도하십시오.

지원

• 본 서버: 이 저장소에 이슈를 제기하십시오.

라이선스

MIT 라이선스 - 자세한 내용은 LICENSE 파일을 참조하십시오.

기여자에게 감사드립니다

이 프로젝트를 더 나은 방향으로 발전시키는 데 기여해주신 모든 분께 진심으로 감사드립니다.