icici-mcp
MCP服务器 ICICI直接 --通过与任何人的自然对话交易印度股票 MCP兼容 AI助手。
为什么选择MCP服务器而不是Python库？
传统的Breeze Connect包装器要求您编写Python代码进行交易。有了icici mcp，你只需说：
You: "Buy 50 Reliance at market price"
Assistant: checks quote, verifies funds, asks for confirmation, places order
You: "How's my portfolio doing?"
Assistant: fetches holdings, calculates P&L, summarizes gainers and losers
You: "Show me the NIFTY option chain for next expiry"
Assistant: fetches option chain data with strikes, premiums, and OI没有代码。没有脚本。没有终端。只是谈话。
icici mcp通过14个交易工具、自动TOTP登录和过期令牌的自动重试，将任何兼容mcp的AI助手直接连接到您的icici Direct帐户。
运作原理
You (natural language) --> AI Assistant --> icici-mcp (MCP server) --> ICICI Direct Breeze API你的人工智能助手解释你的意图，将股票名称映射到符号（例如，“Infosys”到INFY），检查你的资金，并执行交易——所有这些都是通过MCP协议完成的。服务器自动处理身份验证，包括通过TOTP进行每日令牌刷新。
特性
14种完全交易控制工具：
| 工具 | 说明 |
|---|---|
icici_login | 使用TOTP进行自动身份验证 |
get_holdings | 损益组合持股 |
get_demat_holdings | 您demat帐户中的所有股份 |
get_positions | 今天的空缺职位 |
get_orders | 日期范围的订单历史记录 |
get_margins | 可用交易保证金 |
get_funds | 您账户中的可用资金 |
get_quote | 实时市场报价（股票和F&O） |
get_historical_data | 历史OHLCV蜡烛数据 |
get_option_chain | 期权链报价，包括罢工和溢价 |
place_order | 下达买入/卖出订单（市价、限价、止损） |
modify_order | 修改待处理订单 |
cancel_order | 取消待处理订单 |
square_off | 清空未平仓头寸 |
关键能力：
- 全自动登录——TOTP即时生成，无需人工干预
- 对过时的令牌自动重试——如果令牌在会话中期过期，则透明地重新进行身份验证
- F&O分析的期权链数据
- 支持股票（现金）、期货、期权、保证金和BTST订单
兼容
适用于任何MCP兼容客户端，包括：
| 客户端 | 平台 |
|---|---|
| 克劳德桌面 | macOS、Windows |
| 克劳德代码 | 终端（macOS、Linux、Windows） |
| 光标 | macOS、Windows、Linux |
| 帆板运动 | macOS、Windows、Linux |
| 继续 | VS Code，JetBrains |
| 任何兼容MCP的客户端 | 请参阅 MCP客户端列表 |
快速开始
1.安装
pip install icici-mcp
playwright install chromium注： 这 playwright install chromium 自动TOTP登录需要一次步骤。它下载了一个无头Chromium浏览器（约90MB），用于自动登录ICICI Direct。2.获取您的证书
你需要一个 ICICI直接API 应用程序。从您的应用程序仪表板中，记录您的 API密钥 和 API秘密.
您还需要：
- 用户ID --您的ICICI Direct客户ID
- 密码 --您的ICICI直接登录密码
- TOTP秘密 （推荐）--为ICICI Direct 2FA设置外部身份验证器应用程序的base32种子。这实现了完全自动登录，无需手动步骤。
How to get your TOTP secret
- 登录到 secure.icicdirect.com
- 首选 简介 > 安全设置 > 2FA/TOTP设置
- 选择设置 外部身份验证器应用程序 （谷歌身份验证器、Authy等）
- 当二维码出现时，寻找 “无法扫描？复制此密钥” 链接或使用QR解码器提取秘密
- 该密钥是您的TOTP密钥——在完成设置之前保存它
- 输入身份验证器中的6位代码以完成
3.配置您的MCP客户端
将此添加到MCP客户端配置中。配置位置取决于您的客户端——有关确切路径，请参阅客户端的文档。
{
"mcpServers": {
"icici": {
"command": "icici-mcp",
"env": {
"ICICI_API_KEY": "your-api-key",
"ICICI_API_SECRET": "your-api-secret",
"ICICI_USER_ID": "your-user-id",
"ICICI_PASSWORD": "your-password",
"ICICI_TOTP_SECRET": "your-totp-secret",
"ICICI_SESSION_TOKEN": ""
}
}
}
}重新启动MCP客户端。你准备好交易了。
4.试试看
打开新聊天室并尝试：
- “显示我的投资组合”
- “信实的交易价格是多少？”
- “以市场价格购买10台Infosys”
- “我有多少现金？”
- “取消我上一个待处理的订单”
- “显示最近到期日的九个期权链”
人工智能助手可以用简单的英语理解股票名称，无需使用交易符号。
环境变量
| 变量 | 必填 | 描述 |
|---|---|---|
ICICI_API_KEY | 是 | ICICI Direct API密钥 |
ICICI_API_SECRET | 是 | ICICI Direct API机密 |
ICICI_USER_ID | 是 | ICICI直接客户端ID |
ICICI_PASSWORD | 是 | ICICI直接登录密码 |
ICICI_TOTP_SECRET | 没有 | TOTP base32种子用于自动登录。没有这个，你必须跑 icici-mcp-login 每天手动或设置 ICICI_SESSION_TOKEN. |
ICICI_SESSION_TOKEN | 没有 | 来自ICICI Direct API登录页面的手动会话令牌。如果您无法设置TOTP自动登录，请使用此选项。 |
手动登录
如果你没有TOTP密码，你可以每天手动登录：
选项1：使用CLI工具
export ICICI_API_KEY=your-api-key
export ICICI_API_SECRET=your-api-secret
export ICICI_USER_ID=your-user-id
export ICICI_PASSWORD=your-password
icici-mcp-login这将缓存当天剩余时间的会话令牌。MCP服务器将使用缓存的令牌，直到它过期。
选项2：直接设置ICICI_SESSION_TOKEN
- 访问
https://api.icicidirect.com/apiuser/login?api_key=YOUR_API_KEY - 手动完成登录流程
- 复制
apisession重定向URL中的值 - 设置为
ICICI_SESSION_TOKEN在MCP客户端配置中
用例
- 日常投资组合监控 --“给我一份关于我的投资组合的总结，包括最大的赢家和输家”
- 快速交易 --“买50个信实”/“卖掉我所有的Yes Bank”
- F&O交易 --“给我看BANKNIFTY期权链”/“购买1手NIFTY 25000 CE”
- 研究+行动 --“HDFC Bank的52周高点是多少？我应该在目前的水平上增加更多吗？”
- 仓位管理 --“清空我所有的保证金头寸”
- 预定报告 --结合MCP计划任务，在上午9点获得每日投资组合摘要
路线图
- \[\]篮下订单--在一个命令中下多个订单
- \[\]共同基金工具——购买、赎回、检查SIPs
- \[\]IPO申请工具
- \[\]投资组合分析——行业分配、多元化得分
- \[\]多账户支持
有主意吗？ 打开功能请求.
发展
git clone https://github.com/aranjan/icici-mcp.git
cd icici-mcp
python -m venv venv
source venv/bin/activate
pip install -e .安全
- 凭据通过环境变量传递，从不存储在代码中
- 会话令牌在本地缓存在
~/.icici_direct_token.json每天到期 - 服务器在您的计算机上本地运行，不会向第三方服务器发送任何数据
- 与ICICI Direct的所有通信都使用HTTPS
许可证
麻省理工学院