Kite MCP Server

Kite MCP Server

Zerodha Kite API と連携するための Model Context Protocol（MCP）サーバーです。このサーバーを使うと、Claude が Kite の取引アカウントとやり取りするためのツールを利用できます。

特長

• ポートフォリオ管理：ポジション、保有資産、注文を取得します
• マーケットデータ：リアルタイムの気配値、LTP、銘柄データを取得します
• 注文管理：注文の発注、変更、キャンセルを行います
• アカウント情報：プロフィール、証拠金、認証ステータスを確認します
• 安全な認証：トークンを永続化する OAuth 2.0 フローを使用します

前提条件

1. Zerodha Kite Connect アプリ：Kite Connect でアプリを作成します
2. API 認証情報：API Key と Secret を取得します
3. Bun：最新バージョンの Bun ランタイム

インストール

1. クローンして依存関係をインストールします。

bun install

2. 環境変数を設定します。

# Edit .env with your API credentials

3. Kite Connect アプリにリダイレクト URL を設定します。

http://localhost:50000/zerodha/auth/redirect

クイックスタート

1. Kite API で認証する

bun run auth

これにより、次の処理が行われます。

• ローカルの OAuth サーバーを起動します
• Kite のログインページをブラウザーで開きます
• アクセストークンを安全に保存します

2. MCP サーバーを起動する

bun start

3. Claude Desktop を設定する

Claude Desktop の設定に追加します。

{
  "mcpServers": {
    "kite": {
      "command": "bun",
      "args": ["run", "/path/to/kite-mcp/src/index.ts"]
    }
  }
}

利用可能なツール

ポートフォリオツール

• get_profile - ユーザープロフィール情報を取得します
• get_positions - 現在の取引ポジションを取得します
• get_holdings - 長期保有資産を取得します
• get_margins - アカウントの証拠金と資金を取得します

注文ツール

• get_orders - 本日の注文を取得します
• place_order - 新しい取引注文を発注します
• cancel_order - 既存の注文をキャンセルします

マーケットデータツール

• get_ltp - 銘柄の最終取引価格を取得します
• get_quote - 詳細なマーケット気配値を取得します
• get_instruments - 取引可能な銘柄の一覧を取得します

ユーティリティツール

• get_auth_status - 認証ステータスを確認します

プロジェクト構成

src/
├── config/
│   └── environment.ts          # Configuration management
├── auth/
│   ├── token-manager.ts        # Token storage and validation
│   └── oauth-server.ts         # OAuth flow handling
├── api/
│   └── kite-client.ts          # Kite API wrapper
├── mcp/
│   ├── server.ts               # MCP server implementation
│   └── tools/
│       └── index.ts            # MCP tools definitions
├── auth.ts                     # Authentication entry point
└── index.ts                    # MCP server entry point

開発

ビルド（任意）

bun run build

開発モード

bun run dev          # Watch mode for MCP server
bun run dev:auth     # Watch mode for auth server

アーキテクチャ

このプロジェクトは単一責任の原則に従っています。

• ConfigManager：環境と設定を管理します
• TokenManager：トークンの永続化と検証を行います
• OAuthServer：OAuth 2.0 認証フローを処理します
• KiteClient：エラー処理機能を備えた Kite API ラッパーです
• KiteMCPServer：MCP プロトコルを実装します
• Tools：個々の MCP ツールを実装します

環境変数

API_KEY=your_kite_api_key        # Required: Kite Connect API Key
API_SECRET=your_kite_api_secret  # Required: Kite Connect API Secret
OAUTH_PORT=50000                 # Optional: OAuth server port (default: 50000)

セキュリティ

• トークンはローカルの access_token.json に保存されます
• OAuth フローでは安全なリダイレクト処理を使用します
• API 認証情報がログに記録されたり、公開されたりすることはありません
• セキュリティのため、トークンは自動的に期限切れになります

トラブルシューティング

認証に関する問題

1. .env の API 認証情報を確認します
2. Kite Connect アプリの設定でリダイレクト URL を確認します
3. OAuth ポート（50000）が使用可能であることを確認します

トークンの有効期限切れ

• Kite のトークンは約 6 時間ごとに期限切れになります
• 期限切れになったら bun run auth を再実行します
• サーバーから認証ステータスが通知されます

MCP 接続に関する問題

1. Claude Desktop の設定を確認します
2. サーバーが実行中であることを確認します：bun start
3. Claude Desktop のログでエラーを確認します

コントリビューション

1. リポジトリをフォークします
2. 機能ブランチを作成します
3. 既存のコード構成とパターンに従います
4. 適切なエラー処理を追加します
5. プルリクエストを送信します

ライセンス

MIT License - 詳細は LICENSE ファイルを参照してください

免責事項

これは Zerodha Kite API との非公式な連携機能です。自己責任でご利用ください。取引や注文を実行する前に、必ず内容を確認してください。