Angel One Mcp Server

Angel One MCP Server

Angel One Limited（原 Angel Broking Limited）成立于 1996 年，是印度领先的股票经纪公司，服务于超过 2,470 万名客户，业务覆盖 BSE 和 NSE 等印度主要证券交易所。此服务可访问印度股票市场、大宗商品和衍生品交易。

一个通过 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，因为这样可以将敏感凭据与配置文件分开保存。

使用示例

投资组合管理

• “显示我当前的持仓”
• “我有多少可用保证金？”
• “显示我的未平仓头寸”

交易

• “以市价买入 100 股 RELIANCE”
• “以 ₹3500 的价格挂出卖出 50 股 TCS 的限价单”
• “取消订单 ID 12345”

市场数据

• “NIFTY 的当前价格是多少？”
• “显示今天的涨幅榜”
• “获取 SBIN 的历史数据”

安全功能

• 基于 TOTP 的自动身份验证
• 可配置的订单数量限制
• 用于测试的试运行模式
• 全面的错误处理
• 不在内存中存储凭据

要求

• Python 3.8+
• Angel One SmartAPI 账户
• 有效的 API 凭据和 TOTP 设置

许可证

MIT 许可证