mcpField
Z
Zerodha MCP Integration

Zerodha MCP Integration

ローカル
github.com/aptro金融データ4681 週間前に更新
リポジトリ

Zerodha MCP Integration について

Zerodha MCP Integration は、Zerodha Kite Connect API に接続する MCP サーバーで、株式および投資信託の取引口座を操作できます。Claude から口座の照会や取引を行いたいユーザー向けです。

主な機能

  1. 01証拠金、保有銘柄、ポジションの照会
  2. 02株価とヒストリカルデータの取得
  3. 03株式および投資信託の注文発注
  4. 04投資信託 SIP の作成、変更、解約
  5. 05ローカルでのZerodhaログインとトークン保存

活用シーン

  1. 01Claude から保有銘柄と証拠金を確認
  2. 02自然言語で株価やヒストリカルデータを照会
  3. 03投資信託の SIP スケジュールを管理

MCP 対応

本プロジェクトは MCP サーバーとして、Claude Desktop などの MCP クライアントに口座照会、注文発注、SIP 管理のツールを提供します。認証時にはローカルサーバーを起動し、ブラウザで Zerodha にログインします。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "zerodha": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli"
      ]
    }
  }
}
起動コマンドnpx -y @smithery/cli

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npm@smithery/cli

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

Zerodha MCP 統合

smithery badge

このプロジェクトは、Multi-Cloud Plugin（MCP）フレームワークを使用して、Zerodha の取引プラットフォームを Claude AI と統合します。Claude を通じて、Zerodha の取引アカウントを直接操作できます。

セットアップ手順

Smithery 経由でインストールする

Smithery 経由で、Claude Desktop に zerodha-mcp を自動的にインストールするには、次の手順を実行します。

npx -y @smithery/cli install @aptro/zerodha-mcp --client claude
1. Zerodha 開発者アカウントを作成する
  1. Kite Connect にアクセスし、開発者アカウントに登録します
  2. developers.kite.trade でアカウントにログインします
2. 新しいアプリを作成する
  1. Kite Developer ダッシュボードの「Apps」セクションに移動します
  2. 「Create a new app」をクリックします
  3. 必要な情報を入力します。
    • アプリ名：説明的な名前を選択します（例：「Claude Zerodha Integration」）
    • アプリカテゴリー：「Personal」または適切なカテゴリーを選択します
    • リダイレクト URL：http://127.0.0.1:5000/zerodha/auth/redirect に設定します
    • 説明：アプリケーションの目的を簡潔に説明します
  4. フォームを送信してアプリを作成します
3. API 認証情報を取得する

アプリを作成すると、次の情報が発行されます。

  • API Key（Consumer Key とも呼ばれます）
  • API Secret（Consumer Secret とも呼ばれます）

これらの認証情報は、アプリの詳細ページに表示されます。

4. 環境変数を設定する
  1. このプロジェクトのルートディレクトリに .env ファイルを作成します
  2. API 認証情報をファイルに追加します。
KITE_API_KEY=your_api_key_here
KITE_API_SECRET=your_api_secret_here

your_api_key_here と your_api_secret_here を、手順 3 で取得した実際の認証情報に置き換えます。

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

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

uv pip install kiteconnect fastapi uvicorn python-dotenv httpx
6. Claude デスクトップアプリに MCP 設定をインストールする

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

mcp install main.py

このコマンドにより、Zerodha プラグインが Claude に登録され、すべての取引機能を AI が利用できるようになります。

使い方

セットアップ後、次の機能を使って Claude から Zerodha アカウントを操作できます。

認証
Can you please check if I'm logged into my Zerodha account and authenticate if needed?
株式と一般的な取引
  • アカウントの証拠金を確認する：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や第三者に送信されることはありません
  • すべての認証は、ユーザーとZerodhaのサーバー間で直接行われます

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。