Zerodha MCP統合

このプロジェクトは、マルチクラウド プラグイン (MCP) フレームワークを使用して Zerodha の取引プラットフォームを Claude AI と統合し、Claude を通じて Zerodha 取引アカウントと直接やり取りできるようにします。

セットアップ手順

1. Zerodha開発者アカウントを作成する

1. Kite Connectにアクセスして開発者アカウントにサインアップしてください
2. developer.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 資格情報をファイルに追加します。

your_api_key_hereとyour_api_secret_here手順 3 の実際の資格情報に置き換えます。

5. 依存関係をインストールする

必要な依存関係がすべてインストールされていることを確認してください。

6. ClaudeデスクトップアプリにMCP configをインストールする

Claude デスクトップ アプリに MCP 構成をインストールします。

このコマンドは、Zerodha プラグインを Claude に登録し、すべての取引機能を 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ファイルに保存されます。
• 資格情報はクロードや第三者に送信されません
• すべての認証は、あなたとZerodhaのサーバー間で直接行われます