Zerodha MCP

🚀 Zerodha MCP 統合

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

🚀 クイックスタート

このセクションでは、Zerodha MCPのインストール、設定、使用方法を説明します。

📦 インストール

Smitheryを使用したインストール

Smithery を通じてClaude Desktop用のzerodha-mcpを自動インストールするには、以下のコマンドを実行します。

npx -y @smithery/cli install @aptro/zerodha-mcp --platform windows

📚 ドキュメント

設定手順

開発者アカウントの作成

1. Kite Portal にアクセスし、開発者アカウントを登録します。
2. ログイン後、「API アカウント」セクションに移動し、新しいAPIアカウントを作成します。
3. 生成された API Key と Secret Key を記録します。

API認証情報の生成

1. プロジェクトのルートディレクトリに、以下の2つのファイルを作成します。

   • appsettings.json
   • zerodha_credentials.json

2. appsettings.json に以下の内容を追加します。

{
  "Zerodha": {
    "KiteApiKey": "your_api_key_here",
    "KiteSecretKey": "your_secret_key_here"
  }
}

3. zerodha_credentials.json に以下の内容を追加します。

{
  ".consumer_key": "your_api_key_here",
  "consumer_secret": "your_secret_key_here",
  "access_token": null,
  "access_token_secret": null
}

💻 使用例

基本的な使用法

認証

1. プロジェクトで必要な名前空間をインポートします。

using ZerodhaMCP;
using Microsoft.Extensions.Configuration;

2. 設定とMCPインスタンスを初期化します。

var configuration = new ConfigurationBuilder()
    .SetBasePath(Directory.GetCurrentDirectory())
    .AddJsonFile("appsettings.json")
    .Build();

IMCP zerodhaMcp = new ZerodhaMCP.ZerodhaMCPClient(configuration);

3. MCPツールを使用します。

// リクエストトークンを取得
var requestToken = await zerodhaMcp.GetRequestTokenAsync();

// ログインフローを開始
await zerodhaMcp.InitiateLogin(requestToken.token, "http://localhost:8080");

利用可能なMCPツール

認証

• CheckAndAuthenticate - 認証状態を確認し、必要に応じてログインを開始
• InitiateLogin - Zerodhaのログインフローを開始
• GetRequestToken - リクエストトークンを取得

株式/一般取引

• PlaceOrder - 注文を入力
• ModifyOrder - 注文を修正
• CancelOrder - 注文をキャンセル
• GetPosition - ポジションを取得
• GetHoldings - 保有株を取得
• GetQuotes - 相場を取得
• GetHistoricalData - 履歴データを取得

キャッシュ管理

• PlaceMFOrder - ファンド注文を入力
• ModifyMFOrder - ファンド注文を修正
• CancelMFOrder - ファンド注文をキャンセル
• GetMFHoldings - ファンド保有株を取得
• GetMFSips - SIPを取得
• PlaceMFSip - SIPを作成
• ModifyMFSip - SIPを修正
• CancelMFSip - SIPをキャンセル

トラブルシューティング

• 認証問題が発生した場合は、.tokens ファイルを削除し、ログインフローを再開してみてください。
• appsettings.json と zerodha_credentials.json の認証情報が正しいことを確認してください。
• ポート8080が他のアプリケーションによって使用されていないことを確認してください。
• ヘルプが必要な場合は、Zerodha 開発者フォーラム にアクセスしてください。

セキュリティに関する注意事項

• あなたのZerodha API認証情報は、ローカルの appsettings.json ファイルにのみ保存されます。
• アクセストークンは、プロジェクトディレクトリ内の .tokens ファイルに保存されます。
• 認証情報はClaudeや他のサードパーティには送信されません。
• すべての認証は、あなたとZerodhaのサーバー間で直接行われます。