Angel One Mcp Server

Angel One MCP サーバー

Angel One Limited（旧社名：Angel Broking Limited）は、1996年に設立されたインドを代表する証券会社です。BSEやNSEをはじめとするインドの主要証券取引所で、2,470万人を超えるクライアントにサービスを提供しています。このサーバーでは、インドの株式市場、商品、デリバティブ取引にアクセスできます。

Angel One の SmartAPI を通じて、包括的な取引機能と市場データ機能を提供する Model Context Protocol（MCP）サーバーです。

機能

ポートフォリオ管理

• 株式保有状況と投資ポートフォリオを表示
• 家族口座の保有状況を包括的に取得
• 現在の取引ポジションを確認
• リスク管理システム（RMS）の制限にアクセス

取引操作

• 買い注文／売り注文を発注（成行、指値、ストップロス）
• 既存の注文を変更
• 注文をキャンセル
• 注文一覧と取引履歴を表示
• GTT（トリガー発動まで有効）ルールを作成

市場データ

• リアルタイムの最終取引価格（LTP）
• 過去のローソク足（OHLC）データ
• 株式や金融商品を検索
• 値上がり銘柄／値下がり銘柄の分析
• 市場センチメントを示すプット・コール・レシオ（PCR）

高度な機能

• オプションのグリークスを計算
• ポジションを変換
• 取引手数料を見積もり
• TOTP による認証を自動化
• 包括的なエラー処理
• 安全制御とドライランモード

インストール

開発版のインストール（現在）

# Clone the repository
git clone https://github.com/YOUR_USERNAME/angel-one-mcp-server.git
cd angel-one-mcp-server

# Install dependencies
pip install -r requirements.txt

# Install in development mode
pip install -e .

PyPI からのインストール（近日公開）

pip install angel-one-mcp

設定

次のいずれかの方法で Angel One の認証情報を設定できます。

方法 1：環境変数（推奨）

プロジェクトディレクトリに .env ファイルを作成します。

ANGEL_ONE_API_KEY=your_api_key
ANGEL_ONE_CLIENT_CODE=your_client_code
ANGEL_ONE_PASSWORD=your_password
ANGEL_ONE_TOTP_SECRET=your_totp_secret
MAX_ORDER_QUANTITY=10000
DRY_RUN_MODE=false

次に、Claude Desktop（claude_desktop_config.json）を設定します。

{
  "mcpServers": {
    "angel-one-trading": {
      "command": "python",
      "args": ["-m", "angel_one_mcp.server"]
    }
  }
}

方法 2：直接設定

Claude Desktop（claude_desktop_config.json）で認証情報を直接設定します。

{
  "mcpServers": {
    "angel-one-trading": {
      "command": "python",
      "args": ["-m", "angel_one_mcp.server"],
      "env": {
        "ANGEL_ONE_API_KEY": "your_api_key",
        "ANGEL_ONE_CLIENT_CODE": "your_client_code", 
        "ANGEL_ONE_PASSWORD": "your_password",
        "ANGEL_ONE_TOTP_SECRET": "your_totp_secret"
      }
    }
  }
}

注： 方法 1 を推奨します。機密性の高い認証情報を設定ファイルから分離できるためです。

使用例

ポートフォリオ管理

• 「現在の保有銘柄を表示して」
• 「利用可能な証拠金はいくら？」
• 「保有中のポジションを表示して」

取引

• 「RELIANCE を 100 株、成行で買って」
• 「TCS を 50 株、₹3500 の指値で売る注文を出して」
• 「注文 ID 12345 をキャンセルして」

市場データ

• 「NIFTY の現在価格はいくら？」
• 「今日の値上がり銘柄を表示して」
• 「SBIN の過去のデータを取得して」

セキュリティ機能

• TOTP ベースの認証を自動化
• 注文数量の上限を設定可能
• テスト用のドライランモード
• 包括的なエラー処理
• 認証情報をメモリに保存しない

要件

• Python 3.8+
• Angel One SmartAPI アカウント
• 有効な API 認証情報と TOTP の設定

ライセンス

MIT ライセンス