Angel One MCP Server

Angel One Limited（前身为 Angel Broking Limited）是印度领先的股票经纪公司，成立于1996年，通过包括BSE和NSE在内的印度主要证券交易所为超过2470万客户提供服务。该服务器提供对印度股票市场、大宗商品和衍生品交易的访问权限。

这是一个基于 Model Context Protocol（MCP）的服务器，通过 Angel One 的 SmartAPI 提供全面的交易和市场数据功能。

功能特性

投资组合管理

• 查看股票持仓和投资组合

• 获取家庭账户的完整持仓信息

• 查看当前交易持仓

• 查看风险管理系统（RMS）限额

交易操作

• 下达买入/卖出订单（市价、限价、止损）

• 修改现有订单

• 取消订单

• 查看订单簿和交易历史

• 创建 GTT（触发前有效）规则

市场数据

• 实时最新成交价（LTP）

• 历史K线（OHLC）数据

• 搜索股票和交易工具

• 涨幅股/跌幅股分析

• 认购认沽比率（PCR），用于判断市场情绪

高级功能

• 期权希腊值（Option Greeks）计算

• 持仓转换

• 佣金估算

• 基于 TOTP 的自动认证

• 全面的错误处理

• 安全控制和试运行（dry-run）模式

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 凭证：

方式一：环境变量（推荐）

在你的项目目录中创建一个 .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"]
    }
  }
}

方式二：直接在文件配置

直接在 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"
      }
    }
  }
}

注意： 推荐使用方式一，因为它能将敏感凭证与配置文件分离存放。

使用示例

投资组合管理

• “查看我当前的持仓”

• “我还有多少可用保证金？”

• “显示我的未平仓持仓”

交易

• “以市价买入100股 RELIANCE”

• “以 ₹3500 的价格卖出 50 股 TCS 的限价订单”

• “取货订单 ID 12345”

市场数据

• “NIFTY 当前价格是多少？”

• “显示今日涨幅最大的板块”

• “获取 SBIN 的历史数据”

安全特性

• 基于 TOTP 的自动身份认证

• 可配置的订单数量限制

• 试运行模式（dry-run），供测试使用

• 全面的错误处理机制

• 不在内存中保留任何凭证

要求

• Python 3.8 及以上

• Angel One SmartAPI 账户

• 有效的 API 凭证和 TOTP 设置

许可证

MIT License