股票交易服务器

Angel One MCP服务器

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

模型上下文协议（MCP）服务器，通过其SmartAPI为Angel One提供全面的交易和市场数据功能。

特性

投资组合管理

• 查看股票持有量和投资组合
• 获得全面的家庭账户持有
• 查看当前交易头寸
• 访问风险管理系统（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”
• “下达限价订单，以50 TCS的价格出售₹3500"
• “取消订单ID 12345”

市场数据

• “NIFTY的当前价格是多少？”
• “今天给我看涨幅最大的股票”
• “获取SBIN的历史数据”

安全功能

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

需求

• Python 3.8+
• 天使一号SmartAPI账户
• 有效的API凭证和TOTP设置

许可证

MIT许可证