Zerodha MCP 통합

이 프로젝트는 Multi-Cloud Plugin(MCP) 프레임워크를 사용하여 Zerodha의 거래 플랫폼을 Claude AI와 통합하여 Claude를 통해 Zerodha 거래 계좌와 직접 상호 작용할 수 있도록 합니다.

설치 지침

1. Zerodha 개발자 계정 생성

1. Kite Connect 로 이동하여 개발자 계정에 가입하세요.
2. developers.kite.trade 에서 귀하의 계정에 로그인하세요.

2. 새로운 앱 만들기

1. Kite 개발자 대시보드의 "앱" 섹션으로 이동합니다.
2. "새 앱 만들기"를 클릭하세요
3. 필수 세부 정보를 입력하세요:
   • 앱 이름: 설명적인 이름을 선택하세요(예: "Claude Zerodha 통합")
   • 앱 카테고리: "개인" 또는 적절한 카테고리를 선택하세요.
   • 리디렉션 URL: http://127.0.0.1:5000/zerodha/auth/redirect 로 설정
   • 설명: 귀하의 신청서의 목적을 간략하게 설명하세요.
4. 앱을 만들기 위해 양식을 제출하세요

3. API 자격 증명 가져오기

앱을 만들면 다음을 받게 됩니다.

• API 키(소비자 키라고도 함)
• API 비밀(소비자 비밀이라고도 함)

이러한 자격 증명은 앱의 세부 정보 페이지에 표시됩니다.

4. 환경 변수 구성

1. 이 프로젝트의 루트 디렉토리에 .env 파일을 만듭니다.
2. API 자격 증명을 파일에 추가합니다.

지엑스피1

3단계의 실제 자격 증명으로 your_api_key_here 와 your_api_secret_here 바꾸세요.

5. 종속성 설치

필수 종속성이 모두 설치되어 있는지 확인하세요.

6. Claude 데스크톱 앱에 MCP 구성을 설치하세요.

Claude 데스크톱 앱에 MCP 구성을 설치하세요.

이 명령은 Claude에 Zerodha 플러그인을 등록하여 AI가 모든 거래 기능을 사용할 수 있도록 합니다.

용법

설정 후 Claude를 통해 다음 기능을 사용하여 Zerodha 계정과 상호 작용할 수 있습니다.

입증

주식 및 일반 거래

• 계좌 증거금 확인: What are my current margins on Zerodha?
• 포트폴리오 보유 자산 보기: Show me my current holdings on Zerodha
• 현재 채용 공고 확인하기: What positions do I currently have open on Zerodha?
• 심볼에 대한 견적을 받아보세요: What's the current price of RELIANCE and INFY on NSE?
• 주문하기: Place a buy order for 10 shares of INFY at market price on NSE
• 과거 데이터 가져오기: Can you show me the historical price data for SBIN for the last 30 days?

뮤추얼펀드

• 뮤추얼 펀드 보유 현황 보기: Show me my mutual fund holdings on Zerodha
• 뮤추얼 펀드 주문 받기: List all my mutual fund orders on Zerodha
• 뮤추얼 펀드 주문하기: Place a buy order for ₹5000 in the mutual fund with symbol INF090I01239
• 뮤추얼 펀드 주문 취소: Cancel my mutual fund order with order ID 123456789
• SIP 세부 정보 보기: Show all my active SIPs on Zerodha
• 새 SIP 만들기: Set up a monthly SIP of ₹2000 for the fund with symbol INF090I01239 for 12 installments
• 기존 SIP 수정: Change my SIP with ID 987654321 to ₹3000 per month
• SIP 취소: Cancel my SIP with ID 987654321
• 사용 가능한 뮤추얼 펀드 찾아보기: Show me a list of available mutual funds on Zerodha

인증 흐름

Zerodha 기능을 처음 사용할 때 Claude는 다음을 수행합니다.

1. 포트 5000에서 로컬 서버를 시작합니다.
2. Zerodha 로그인을 위해 브라우저 창을 엽니다.
3. 로그인에 성공하면 향후 세션을 위해 액세스 토큰을 저장합니다.

토큰이 만료될 때까지(일반적으로 24시간) 세션이 활성 상태로 유지됩니다. 토큰이 만료되면 Claude가 자동으로 로그인 흐름을 다시 시작합니다.

사용 가능한 MCP 도구

이 플러그인은 Claude가 사용할 수 있는 다음과 같은 MCP 도구를 제공합니다.

입증

• check_and_authenticate - 인증 상태를 확인하고 필요한 경우 로그인을 시작합니다.
• initiate_login - Zerodha 로그인 흐름을 시작합니다.
• get_request_token - 로그인 후 요청 토큰을 검색합니다.

주식/일반 거래

• get_holdings - 포트폴리오 보유 자산을 검색합니다.
• get_positions - 현재 위치를 가져옵니다
• get_margins - 계정 마진을 검색합니다.
• place_order - 거래 주문을 합니다
• get_quote - 지정된 기호에 대한 인용문을 가져옵니다.
• get_historical_data - 과거 가격 데이터를 검색합니다.

뮤추얼펀드

• get_mf_orders - 뮤추얼 펀드 주문을 검색합니다.
• place_mf_order - 뮤추얼 펀드 주문을 합니다
• cancel_mf_order - 뮤추얼 펀드 주문을 취소합니다
• get_mf_instruments - 사용 가능한 뮤추얼 펀드 상품을 가져옵니다.
• get_mf_holdings - 뮤추얼 펀드 지분을 검색합니다.
• get_mf_sips - 활성 SIP를 가져옵니다.
• place_mf_sip - 새로운 SIP를 생성합니다
• modify_mf_sip - 기존 SIP를 수정합니다.
• cancel_mf_sip - SIP를 취소합니다

문제 해결

• 인증 문제가 발생하면 .tokens 파일을 제거하고 인증 프로세스를 다시 시작해 보세요.
• .env 파일에 있는 Zerodha 자격 증명이 올바른지 확인하세요.
• 다른 애플리케이션에서 포트 5000을 사용하고 있지 않은지 확인하세요.
• 지속적인 문제의 경우 status.zerodha.com 에서 Zerodha의 API 상태를 확인하세요.

보안 참고 사항

• Zerodha API 자격 증명은 로컬 .env 파일에만 저장됩니다.
• 액세스 토큰은 프로젝트 디렉토리의 .tokens 파일에 저장됩니다.
• Claude 또는 제3자에게 자격 증명이 전송되지 않습니다.
• 모든 인증은 귀하와 Zerodha 서버 사이에서 직접 이루어집니다.