Angel One MCP Server

Angel One Limited（旧称：Angel Broking Limited）は、1996年に設立されたインドを代表する証券会社で、BSEやNSEなどのインドの主要証券取引所で2,470万人以上の顧客にサービスを提供しています。本サーバーは、インドの株式市場、商品、デリバティブ取引へのアクセスを提供します。

Angel One の SmartAPI を介して、総合的な取引機能とマーケットデータ機能を提供する Model Context Protocol（MCP）サーバーです。

機能

ポートフォリオ管理

• 株式の保有状況と投資ポートフォリオを表示

• ファミリー口座の包括的な保有情報を取得

• 現在の取引ポジションを確認

• リスク管理システム（RMS）の限度額を確認

取引機能

• 買い・売り注文の発注（成行、指値、逆指値）

• 既存注文の変更

• 注文の取り消し

• 注文一覧と取引履歴の表示

• GTT（Good Till Triggered）ルールの作成

マーケットデータ

• リアルタイムの最終取引価格（LTP）

• 過去のローソク足（OHLC）データ

• 株式・金融商品の検索

• 値上がり・値下がり上位銘柄の分析

• マーケットセンチメントの分析に有効なプット・メール比率（PCR）

高度な機能

• オプション・グリーン（Option Greeks）の計算

• ポジションの変換

• 手数料の見積

• TOTPによる自動認証

• 包括的なエラー処理

• 安全対策とドライラン・モード

Related MCP server: Kite MCP Server

インストール

開発バージョンのインストール（現在）

# 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ライセンス

Does "リアルタイムの最終取引価格（LTP）" – "price" okay. The bullet "値上がり・値下がり上位の分析（値上がり）" — I inadvertently included "(PR)" weird. Let's double-check: In my previous draft "プット・コール比率（PCR）" but I typed "プット・メインル（PCR）" by accident. Fix: "プット・コール比率（PCR）".

Also "リスクシステム管理（RMS）" ok.

"オプション・グリーン（Option Greeks）" — I wrote "オプション・グリーン" but should be "オプション・グリークス" or "オプションのギリシャ値". Let me decide: "オギXi" — Japanese finance uses "複雑な条例" — I'll use "オプションのグリークス（Option Greeks）". Hmm "オプション・グリーク" maybe, but "Greeks" is plural "グリークス". Write "オプションのグリークス（Option Greeks）".

"手金の概算" — 手数料の見積 becomes "brokerage estimation" — okay.

"証拠金は、証拠金" more accurate.

"今日の値上がり上位銘柄を表示して" — correct.

Need to adjust "注文 ID 12345 を取り消して" - okay.

Also "∫角" no.

I have written "ドートラン" - I actually wrote "ドライラン". Good.

Now let me produce the final corrected output, ensuring all spellings accurate.

Let me assemble final content again with these fixes. Ensure " MITライセンス" — should I add space "MIT ライセンス"? Usually "MIT ライセンス" in Japanese, but "MITライセンス" also acceptable. English "MIT License" is a proper noun; Japanese "MIT ライセンス" natural. I'll go with "MIT ライセンス".

Also the heading "## ライセンス" is Japanese, okay.

Potential issue: "The identity "Angel One MCP server" — first line "Angel One MCP Server". Good.

Let me not forget the colon at the end of "Create .env" — use the Japanese colon. In original "directory:" is part of prose. I'll keep ":".

Now I'll produce the response# Angel One MCP Server

Angel One Limited（旧称：Angel Broking Limited）は、1996年に設立されたインドを代表する証券会社で、BSEやNSEを含むインドの主要証券取引所で2,470万人以上の顧客にサービスを提供しています。本サーバーは、インドの株式市場、商品市場、デリバティブ取引へのアクセスを提供します。

Angel OneのSmartAPIを介して、包括的な取引およびマーケットデータ機能を提供するModel Context Protocol（MCP）サーバーです。

機能

ポートフォリオ管理

• 株式の保有状況と投資ポートフォリオを表示

• ファミリー口座の包括的な保有情報を取得

• 現在の取引ポジションを確認

• リスク管理システム（RMS）の限度額を確認

取引機能

• 買い注文・売り注文を発注（成行、限月・指値、逆指値）

• 既存注文を変更

• 注文を取り消す

• 注文帳簿と取引履歴を表示

• GTT（Good Till Triggered）ルールを作成

マーケットデータ

• リアルタイムの最終取引価格（LTP）

• 過去のローソク足（OHLC）データ

• 銘柄・金融商品の検索

• 値上がり・値下がり上位銘柄の分析

• プット・コール比率（PCR）による市場のセンチメント分析

高度な機能

• オプション・グリークス（Option Greeks）の計算

• ポジションの変換

• 手数料の見積もり

• 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 License