Angel One MCP Server

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

功能

投资组合管理

• 查看股票持有量和投资组合
• 获取全面的家庭账户持有量
• 检查当前交易仓位
• 访问风险管理系统（RMS）限额

交易操作

• 下单买入/卖出（市价、限价、止损）
• 修改现有订单
• 取消订单
• 查看订单簿和交易历史
• 创建GTT（触发前有效）规则

市场数据

• 实时最后成交价格（LTP）
• 历史蜡烛图（OHLC）数据
• 股票和工具搜索
• 最大赢家/输家分析
• 市场情绪的买权卖权比率（PCR）

高级功能

• 期权希腊字母计算
• 仓位转换
• 经纪费估算
• 自动TOTP认证
• 完整错误处理
• 安全控制和模拟运行模式

安装

开发安装（当前）

# 克隆仓库
git clone https://github.com/YOUR_USERNAME/angel-one-mcp-server.git
cd angel-one-mcp-server

# 安装依赖
pip install -r requirements.txt

# 开发模式安装
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=11000
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"
• "下单以限价卖出50股TCS，价格为₹3500"
• "取消订单ID 12345"

市场数据

• "NIFTY的当前价格是多少？"
• "显示今天最大的赢家"
• "获取SBIN的历史数据"

安全特性

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

要求

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

许可证

MIT许可证