Angel One

Angel One MCP サーバー

Angel One SmartAPI 用の TypeScript 製 Model Context Protocol サーバーです。

Claude、Cursor、Copilot、または任意の MCP クライアントから、次の操作を行えます。

• 注文の発注と管理
• 保有銘柄、ポジション、資金の確認
• 市場データ、ローソク足、OI、Greeks、値上がり・値下がり銘柄の取得
• GTT ルールの管理
• 料金と必要証拠金の見積もり

主な特長

• fetch() による直接連携。Angel One SDK への依存はありません。
• Base32 シークレットから TOTP を自動生成します。
• API レイヤーでトークンを更新する遅延ログイン。
• ソフトリミットとハードリミットによる、取引操作の安全ガード。
• stdio MCP サーバー。npx での利用に適しています。

検索

• npm パッケージ：angel-one-mcp
• 公式 MCP Registry：io.github.ameernoufil/angel-one
• GitHub リポジトリ：ameernoufil/angel-one-mcp

クライアントがレジストリベースの検索に対応している場合は、io.github.ameernoufil/angel-one を検索してください。 パッケージのインストールを利用するクライアントの場合は、npm から angel-one-mcp を使用してください。

クイックスタート

オプション A：npx で使用する（推奨）

MCP クライアントの設定に次の内容を追加してください。

{
  "mcpServers": {
    "angel-one": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "angel-one-mcp"],
      "env": {
        "ANGEL_API_KEY": "your_smartapi_key",
        "ANGEL_CLIENT_ID": "your_client_id",
        "ANGEL_PASSWORD": "your_mpin",
        "ANGEL_TOTP_SECRET": "your_base32_totp_secret"
      }
    }
  }
}

オプション B：ソースから実行する

git clone https://github.com/ameernoufil/angel-one-mcp.git
cd angel-one-mcp
npm install
cp .env.example .env
npm run build
npm start

ソースから実行する場合は、MCP クライアントの実行先に build/index.js を指定してください。

環境変数

必須：

• ANGEL_API_KEY
• ANGEL_CLIENT_ID
• ANGEL_PASSWORD
• ANGEL_TOTP_SECRET

任意の安全制限：

• SOFT_MAX_ORDER_QTY のデフォルト値は 25
• HARD_MAX_ORDER_QTY のデフォルト値は 100
• SOFT_MAX_ORDER_VALUE のデフォルト値は 10000
• HARD_MAX_ORDER_VALUE のデフォルト値は 100000

.env の例：

ANGEL_API_KEY=your_smartapi_key
ANGEL_CLIENT_ID=your_client_id
ANGEL_PASSWORD=your_mpin
ANGEL_TOTP_SECRET=your_base32_totp_secret

安全モデル

取引操作にはガードが適用されます。

ソフトリミットはデフォルトで操作をブロックし、force: true で回避できます。 ハードリミットは、環境変数を変更してサーバーを再起動しない限り回避できません。

ガード対象の操作：

• place_order
• modify_order
• create_gtt_rule
• modify_gtt_rule
• convert_position

MARKET 注文では、リクエストを許可する前に、サーバーが LTP に基づく金額チェックを試みます。

ツールの対応範囲

• 認証： ログイン、ログアウト
• ポートフォリオ： 保有銘柄、ポジション、資金、変換
• 注文： 発注、変更、取消、注文一覧の照会、取引履歴の照会
• 市場： 検索、LTP、気配値、ローソク足、OI、Greeks、値上がり・値下がり銘柄、PCR
• GTT： 作成、変更、取消、一覧表示、詳細確認
• 計算ツール： 必要証拠金と仲介手数料の見積もり
• ユーザー： プロフィール

エージェント向けのオンボーディング用プロンプトについては、docs/llm-setup.md を参照してください。

開発

必要なもの：

• Node.js 18+

コマンド：

npm install
npm run build
npm run lint
npm run lint:fix
npm run format
npm run dev
npm start

アーキテクチャに関するメモ

• エントリーポイント：src/index.ts
• API クライアントと認証フロー：src/api.ts
• 設定と安全制限：src/config.ts
• 注文ガード：src/guards.ts
• ツールの登録：src/tools/index.ts
• ツールの実装：src/tools/*.ts

ライセンス

MIT