DhanHQ MCP交易助理
用于在DhanHQ上进行交易的MCP(模型上下文协议)服务器。使像Claude这样的人工智能助手能够通过自然语言执行交易、检查投资组合和获取市场数据。
特性
- 订单管理:下达市价/限价订单、盘后订单(AMO)和带有目标/止损的超级订单
- 投资组合:查看持有量、头寸,并在产品类型之间转换头寸
- 账户:检查资金余额并计算保证金要求
- 市场数据:获取LTP、OHLC、市场深度和历史数据
- 订单簿:查看、修改和取消订单
设置
1.克隆存储库
git clone https://github.com/LakshitF/Dhan-MCP-Trades.git
cd Dhan-MCP-Trades2.创建虚拟环境
python -m venv .venv
source .venv/bin/activate # On Windows: .venv\Scripts\activate3.安装依赖项
pip install -r requirements.txt4.配置DhanHQ凭据
编辑 config.py 使用您的DhanHQ凭据:
DHAN_CLIENT_ID = "your_client_id"
DHAN_ACCESS_TOKEN = "your_access_token"从获取您的凭据 DhanHQ开发者门户.
5.添加到克劳德桌面
添加到您的Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上):
{
"mcpServers": {
"dhan-trading": {
"command": "/path/to/Dhan-MCP-Trades/.venv/bin/python",
"args": ["/path/to/Dhan-MCP-Trades/server.py"]
}
}
}可用工具
| 工具 | 说明 |
|---|---|
place_order | 下达买入/卖出订单 |
place_after_market_order | 下一个交易日的AMO |
place_super_order | 有目标的订单和止损 |
list_available_stocks | 列出库存中的股票.json |
get_order_book | 查看当天的所有订单 |
get_trade_book | 查看当天的所有交易 |
cancel_order | 取消待处理订单 |
modify_order | 修改待处理订单 |
get_holdings | 查看demat持有量 |
get_positions | 查看空缺职位 |
check_fund_balance | 检查可用余额 |
calculate_margin | 计算订单的保证金 |
get_ltp | 获取最后交易价格 |
get_ohlc | 获取OHLC数据 |
get_historical_daily | 获取每日历史数据 |
示例用法
配置后,您可以询问Claude:
- “以市场价格购买10股RELIANCE”
- “我目前的资金余额是多少?”
- “显示我的资产”
- “下售后订单购买5 TCS₹3500"
- “INFY目前的价格是多少?”
项目结构
├── server.py # MCP server entry point
├── config.py # DhanHQ credentials
├── stocks.json # Stock security IDs mapping
├── requirements.txt # Python dependencies
├── tools/ # Tool implementations
│ ├── orders.py # Order placement
│ ├── order_book.py # Order management
│ ├── portfolio.py # Holdings & positions
│ ├── account.py # Fund & margin
│ ├── market_data.py # Market data
│ └── statements.py # Trade history
└── utils/ # Utilities
├── api.py # API client
└── stocks.py # Stock lookup许可证
麻省理工学院
