mcpField
A
Angel One

Angel One

本地服务
github.com/ameernoufil金融数据123 周前更新
代码仓库

关于 Angel One

Angel One 是一个通过 MCP 客户端调用 Angel One SmartAPI 的 TypeScript MCP 服务，涵盖交易、投资组合和市场数据，并以限额保护交易变更操作，支持自动生成 TOTP。

主要功能

  1. 01下单及管理订单
  2. 02读取持仓、仓位和资金
  3. 03获取报价、K 线、OI 和 Greeks
  4. 04管理 GTT 规则
  5. 05估算费用和保证金
  6. 06按限额保护交易操作

适用场景

  1. 01通过 MCP 客户端提交或查看订单
  2. 02检查投资组合持仓和可用资金
  3. 03查看市场报价及衍生品数据
  4. 04估算交易费用或所需保证金

MCP 相关

通过 stdio 向 MCP 客户端提供 Angel One SmartAPI 的身份验证、投资组合、订单、市场、GTT 和计算工具。交易变更操作设有可配置的软硬限额。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "ameernoufil-angel-one": {
      "command": "npx",
      "args": [
        "-y",
        "angel-one-mcp"
      ],
      "env": {
        "ANGEL_API_KEY": "<ANGEL_API_KEY>",
        "ANGEL_CLIENT_ID": "<ANGEL_CLIENT_ID>",
        "ANGEL_PASSWORD": "<ANGEL_PASSWORD>",
        "ANGEL_TOTP_SECRET": "<ANGEL_TOTP_SECRET>",
        "SOFT_MAX_ORDER_QTY": "<SOFT_MAX_ORDER_QTY>",
        "HARD_MAX_ORDER_QTY": "<HARD_MAX_ORDER_QTY>",
        "SOFT_MAX_ORDER_VALUE": "<SOFT_MAX_ORDER_VALUE>",
        "HARD_MAX_ORDER_VALUE": "<HARD_MAX_ORDER_VALUE>"
      }
    }
  }
}
启动命令npx -y angel-one-mcp
需要配置的环境变量
ANGEL_API_KEY密钥Angel One SmartAPI app key
ANGEL_CLIENT_ID密钥Angel One client code
ANGEL_PASSWORD密钥Angel One password or MPIN
ANGEL_TOTP_SECRET密钥Base32 TOTP secret used to generate login OTPs
SOFT_MAX_ORDER_QTYSoft max order quantity
HARD_MAX_ORDER_QTYHard max order quantity
SOFT_MAX_ORDER_VALUESoft max order value in INR
HARD_MAX_ORDER_VALUEHard max order value in INR

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npmangel-one-mcp1.0.10

工具

32

收录的工具列表 · 更新于 2 周前

此工具无需参数。

详细介绍

Angel One MCP 服务

npm MCP Registry

适用于 Angel One SmartAPI 的 TypeScript Model Context Protocol 服务。

可通过 Claude、Cursor、Copilot 或任何 MCP 客户端使用它来：

  • 下单并管理订单
  • 查看持仓、头寸和资金
  • 获取市场数据、K 线、OI、Greeks 和涨跌幅榜
  • 管理 GTT 规则
  • 估算费用和保证金

亮点

  • 直接集成 fetch()。不依赖 Angel One SDK。
  • 根据 base32 密钥自动生成 TOTP。
  • 按需登录，并在 API 层刷新令牌。
  • 针对交易变更操作提供安全保护，支持软限制和硬限制。
  • stdio MCP 服务。与 npx 配合使用效果良好。

可发现性

如果你的客户端支持基于 Registry 的发现功能，请搜索 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、报价、K 线、OI、Greeks、涨跌幅榜、PCR
  • GTT： 创建、修改、取消、列出、检查
  • 计算器： 保证金和经纪费估算
  • 用户： 个人资料

面向 Agent 的入门提示词请参阅 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

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。