Dhan Broker MCP Trades

DhanHQ 交易助手

一款基于 AI、面向 DhanHQ 券商的交易助手，使用 Model Context Protocol（MCP）构建。该项目支持通过自然语言与 DhanHQ 交易平台交互，让你通过简单的对话指令下单、查看投资组合并管理交易活动。

功能

订单管理

• 通过 order_placement_tool.py 下普通订单（市价单／限价单）
• 通过 super-order.py 下带目标价和止损的超级订单
• 通过 after_market_order_tool.py 下盘后订单
• 通过 order_book_tool.py 查看订单簿和交易历史

投资组合管理

• 通过 holdings_positions_tool.py 查看持仓和仓位
• 转换仓位（例如，将日内交易转换为交割交易）

账户信息

• 通过 fund_balance_tool.py 查看资金余额
• 通过 margin_calculator_tool.py 计算保证金要求

设置与安装

前提条件

• Python 3.9 或更高版本
• DhanHQ 交易账户
• DhanHQ API 凭据（客户端 ID 和访问令牌）

安装

1. 克隆此代码库

   git clone https://github.com/yourusername/dhan-broker-mcp-trades.git
   cd dhan-broker-mcp-trades
   

2. 安装所需依赖

   pip install -r requirements.txt
   

3. 配置凭据

   编辑 config.py 文件，填入你的 DhanHQ 凭据：

   DHAN_CLIENT_ID = "your_client_id_here"
   DHAN_ACCESS_TOKEN = "your_access_token_here"
   DHAN_API_BASE_URL = "https://api.dhan.co/v2"
   

4. 确保 stocks.json 文件中已填入你想交易的股票

运行工具

每个工具都可以使用 MCP CLI 独立运行：

# To run the order placement tool
python -m mcp.server.cli dev order_placement_tool.py

# To run the portfolio server
python -m mcp.server.cli dev portfolio_server.py

# To run other tools
python -m mcp.server.cli dev <tool_filename>.py

使用助手

📈 扩展交易指令示例 🛒 基本下单

• “以市价买入 10 股 Infosys”

• “以 ₹3500 的限价卖出 5 股 TCS”

• “下达 GTT 订单，以 ₹1450 买入 20 股 HDFC Bank”

🎯 带止损和目标价的订单

• “买入 Reliance，目标价为 2%，止损为 1%”

• “为 Tata Motors 下达跟踪止损买入订单”

• “做空 Axis Bank，目标价为 5%，止损为 2%”

🌙 盘后和定时订单

• “创建盘后订单，以 ₹180 买入 100 股 ONGC”

• “安排明天上午 9:15 买入 Tech Mahindra”

💼 账户概览

• “我目前持有哪些股票？”

• “查看我的可用余额和保证金”

• “显示我的未平仓仓位和未实现利润”

📊 投资组合与盈亏分析

• “分析我本月的投资组合表现”

• “提供所有银行业交易的盈亏报告”

• “过去 30 天表现最好的股票是什么？”

🤖 智能、具备上下文感知能力的语音指令

• “买入所有 PSU 银行股”

• “今天做空所有私营银行股”

• “做多 Nifty IT 中排名前 5 的公司”

• “买入那家刚举办了盛大婚礼的公司 2 股”

• “跟踪所有化工行业股票的止损价”

📌 上下文与主题交易

• “买入所有总部位于孟买的公司”

• “买入发起人持股比例逐季上升的公司”

• “做空所有严重依赖中国原材料的公司”

• “买入印度市值排名前 5 的公司”

📈 基于技术信号的交易

• “买入突破 200 日移动平均线的股票”

• “做空跌破布林带下轨的股票”

• “买入 RSI 上穿 70 的股票”

• “对均值回归型股票开仓，并设置紧密止损”

🔍 高级筛选与信号扫描

• “买入利润逐季增长超过 10% 的公司”

• “买入较历史高点下跌超过 20% 且成交量较大的股票”

• “卖出所有受全球原油价格影响的股票”

🔁 配对与策略型交易

• “买入 3 股 Reliance，卖出 2 股 Bharti Airtel”

• “在 ICICI Bank 和 Axis Bank 之间进行配对交易”

工具说明

order_placement_tool.py

处理基本下单（市价单和限价单）。支持按名称买卖股票。

super-order.py

管理超级订单，其目标价和止损价可以用绝对值或百分比指定。

after_market_order_tool.py

在交易时段之外下单，并于下一个交易日执行。

fund_balance_tool.py

获取账户资金信息并计算保证金要求。

holdings_positions_tool.py

获取持仓和头寸信息，并支持在不同产品类型之间转换。

margin_calculator_tool.py

计算潜在交易的保证金要求。

order_book_tool.py

提供订单历史和成交记录的访问，并支持撤销订单。

portfolio_server.py

投资组合管理的主接口。

股票信息

项目使用 stocks.json 文件将股票名称映射到其证券 ID。该文件采用以下结构：

{
  "companies": [
    {
      "stock_code": "1333",
      "company_name": "HDFC Bank Ltd.",
      "stock_name": "HDFCBANK",
      "description": "Description of the company..."
    }
  ]
}

贡献

欢迎贡献！请随时提交拉取请求。

许可证

本项目采用 MIT 许可证授权，详情请参阅 LICENSE 文件。

免责声明

本软件仅供教育用途。使用风险自负。创建者不对使用本软件造成的任何财务损失负责。执行前请务必核实所有交易操作。