Zerodha MCP Server

Zerodha MCP Server

Golang で記述された、Zerodha のデータと通信するためのプロトコル

概要

Zerodha MCP Server は、Zerodha の取引データ向けに Claude MCP（Model Completion Protocol）インターフェースを実装しています。これにより、Claude AI は Zerodha の取引口座情報に直接アクセスできます。

前提条件

• Go（バージョン 1.21 以降）
• Zerodha Kite の取引口座
• Claude Desktop App
• Kite Connect developer portal の API 認証情報

インストール

オプション 1：Go Install を使用

go install github.com/sukeesh/zerodha-mcp@latest

オプション 2：ソースからビルド

git clone https://github.com/sukeesh/zerodha-mcp.git
cd zerodha-mcp
go install

バイナリは GOBIN ディレクトリにインストールされます。このディレクトリは PATH に含まれている必要があります。

MCP クライアントでの使用

GPT 4o mini

https://github.com/user-attachments/assets/849c4aca-0ca2-4aed-a9be-3df135f8a5c5

Claude Sonnet 3.7

設定

1. Kite Connect developer portal から ZERODHA_API_KEY と ZERODHA_API_SECRET を取得します。

2. Kite developer portal でリダイレクト URL を設定します：

   http://127.0.0.1:5888/auth
   

3. Claude Desktop を設定します：

   • Claude Desktop を開き、Settings → Developer → Edit Config を選択します
   • claude_desktop_config.json に以下を追加します：

{
  "mcpServers": {
    "zerodha": {
      "command": "<path-to-zerodha-mcp-binary>",
      "env": {
       "ZERODHA_API_KEY": "<api_key>",
       "ZERODHA_API_SECRET": "<api_secret>"
      }
    }
  }
}

4. Claude Desktop を再起動します。プロンプトが表示されたら、Zerodha Kite の認証情報で認証します。

デバッグ

MCP Server のログは ~/Library/Logs/Claude にあります。

既知のバグ

Claude Desktop を終了しても、基盤となる MCP Server が終了しません。

kill -9 $(lsof -t -i:5888)

利用可能なツール

カテゴリ	ツール	状態	説明
口座情報	get_user_profile	✅	ユーザープロフィールの基本情報を取得
	get_user_margins	✅	ユーザーのすべての証拠金を取得
	get_user_segment_margins	✅	セグメント別のユーザー証拠金を取得
ポートフォリオとポジション	get_kite_holdings	✅	Zerodha Kite 口座の現在の保有資産を取得
	get_positions	✅	当日および正味のポジションを取得
	get_order_margins	✅	指定した注文に必要な証拠金を取得
市場データ	get_ltp	✅	指定した銘柄の最終取引価格を取得
	get_quote	✅	指定した銘柄の詳細な相場情報を取得
	get_ohlc	✅	始値、高値、安値、終値の相場情報を取得
銘柄	get_instruments	✅	Zerodha で利用可能なすべての銘柄の一覧を取得
	get_instruments_by_exchange	✅	取引所で絞り込んだ銘柄を取得
	get_auction_instruments	✅	オークションセッションで利用可能な銘柄を取得
投資信託	get_mf_instruments	✅	利用可能なすべての投資信託銘柄の一覧を取得
	get_mf_holdings	✅	投資信託の保有資産一覧を取得
	get_mf_holdings_info	✅	投資信託の保有資産に関する詳細情報を取得
	get_mf_orders	✅	すべての投資信託注文の一覧を取得
	get_mf_order_info	✅	指定した投資信託注文に関する詳細情報を取得
	get_mf_sip_info	✅	投資信託の SIP に関する情報を取得
	get_mf_allotted_isins	✅	割り当て済みの投資信託 ISIN を取得

使用方法

セットアップ後は、Claude を通じて Zerodha 口座のデータを直接操作できます。たとえば、次のように尋ねられます：

• 「現在保有しているポートフォリオを見せて」
• 「現在利用可能な証拠金はいくらですか？」
• 「RELIANCE の最新価格を教えて」
• 「損益付きで、保有中のポジションを見せて」

制限事項

• 読み取り操作のみサポートされています。取引にはまだ対応していません
• 認証トークンは毎日有効期限が切れるため、再ログインが必要です