Angel One MCP Server

Angel One Limited(구 Angel Broking Limited)는 1996년에 설립되어 BSE 및 NSE를 포함한 인도의 주요 증권 거래소에서 2,470만 명 이상의 고객에게 서비스를 제공하는 인도 최고의 증권 중개 회사입니다. 이 서버는 Angel One의 SmartAPI를 통해 인도 주식 시장, 상품, 파생상품 거래에 대한 접근을 제공합니다.

Angel One의 SmartAPI를 통해 원거래 및 시장 데이터 기능을 제공하는 MCP(Model Context Protocol) 서버입니다.

기능

포트폴리오 관리

• 보유 주식 및 투자 포트폴리오 조회

• 전체 가족 계좌 보유 종목 조회

• 현재 거래 포지션 확인

• 위험 관리 시스템(RMS) 한도 접근

거래 작업

• 매수/매도 주문 실행(시장가, 지정가, 손절가)

• 기존 주문 수정

• 주문 취소

• 주문장 및 거래 내역 조회

• GTT(Good Till Triggered) 규칙 생성

시장 데이터

• 실시간 최근 체결가(LTP)

• 과거 캔들스틱(OHLC) 데이터

• 주식 및 금융 상품 검색

• 상승/하락 종목 상위 분석

• 시장 심리 파악을 위한 풋/콜 비율(PCR)

고급 기능

• 옵션 그리크스 계산

• 포지션 변환

• 브로커리지 견적

• TOTP 자동 인증

• 포괄적인 오류 처리

• 안전 제어 및 드라이러닝 모드

Related MCP server: Kite MCP Server

설치

개발 설치(현재)

# Clone the repository
git clone https://github.com/YOUR_USERNAME/angel-one-mcp-server.git
cd angel-one-mcp-server

# Install dependencies
pip install -r requirements.txt

# Install in development mode
pip install -e .

PyPI 설치(준비 중)

pip install angel-one-mcp

구성

Angel One 자격 증명은 다음 두 가지 방법 중 하나로 구성할 수 있습니다.

옵션 1: 환경 변수(권장)

프로젝트 디렉터리에 .env 파일을 만듭니다.

ANGEL_ONE_API_KEY=your_api_key
ANGEL_ONE_CLIENT_CODE=your_client_code
ANGEL_ONE_PASSWORD=your_password
ANGEL_ONE_TOTP_SECRET=your_totp_secret
MAX_ORDER_QUANTITY=10000
DRY_RUN_MODE=false

그런 다음 Claude Desktop(claude_desktop_config.json)을 구성합니다.

{
  "mcpServers": {
    "angel-one-trading": {
      "command": "python",
      "args": ["-m", "angel_one_mcp.server"]
    }
  }
}

옵션 2: 직접 구성

Claude Desktop(claude_desktop_config.json)에서 자격 증명을 직접 구성합니다.

{
  "mcpServers": {
    "angel-one-trading": {
      "command": "python",
      "args": ["-m", "angel_one_mcp.server"],
      "env": {
        "ANGEL_ONE_API_KEY": "your_api_key",
        "ANGEL_ONE_CLIENT_CODE": "your_client_code", 
        "ANGEL_ONE_PASSWORD": "your_password",
        "ANGEL_ONE_TOTP_SECRET": "your_totp_secret"
      }
    }
  }
}

참고: 옵션 1은 민감한 자격 증명을 설정 파일과 분리하여 유지하므로 권장됩니다.

사용 예시

포트폴리오 관리

• "현재 보유 주식 보여줘"

• "사용 가능한 증거금은 얼마인가요?"

• "열린 포지션을 표시해 줘"

거래

• "RELIANCE 100주를 시장가로 매수"

• "TCS 50주를 ₹3500에 지정가로 매도"

• "주문 ID 12345 취소"

시장 데이터

• "NIFTY 현재 가격이 얼마인가요?"

• "오늘 상승 종목 상위를 보여줘"

• "SBIN 과거 데이터 가져와"

보안 기능

• TOTP 기반 자동 인증

• 주문 수량 한도 설정 가능 이 하한

• 테스트를 위한 시뮬레이션 모드

• 포괄적인 오류 처리

• 메모리에 자격 증명 저장 없음

요구 사항

• Python 3.8 이상

• Angel One SmartAPI 계정

• 유효한 API 자격 증명 및 TOTP 설정

라이센스

MIT 라이센스