kite-mcp
MCP服务器 Zerodha风筝 --通过与任何人的自然对话交易印度股票 MCP兼容 AI助手。
为什么选择MCP服务器而不是Python库？
传统的风筝包装器要求你编写Python代码来进行交易。有了kite 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: "Set a stop-loss on my HAL position at 3400"
Assistant: places a GTT trigger for you没有代码。没有脚本。没有终端。只是谈话。
kite mcp通过14个交易工具、自动TOTP登录和过期代币的自动重试，将任何兼容mcp的AI助手直接连接到您的Zerodha账户。
运作原理
You (natural language) --> AI Assistant --> kite-mcp (MCP server) --> Zerodha Kite API你的人工智能助手解释你的意图，将股票名称映射到符号（例如，“Infosys”到NSE:INFY），检查你的资金，并执行交易——所有这些都是通过MCP协议完成的。服务器自动处理身份验证，包括通过TOTP进行每日令牌刷新。
特性
14种完全交易控制工具：
| 工具 | 说明 |
|---|---|
kite_login | 使用TOTP进行自动身份验证 |
get_holdings | 损益组合持股 |
get_positions | 今天的日内/交割头寸 |
get_orders | 今天的订单历史 |
get_margins | 可用资金和利润 |
get_quote | 实时市场报价 |
get_ohlc | 打开、高、低、关闭数据 |
get_historical_data | 历史蜡烛数据（分钟到每天） |
get_instruments | 在NSE、BSE、NFO、MCX中搜索可交易的工具 |
place_order | 下达买入/卖出订单（市价、限价、止损） |
modify_order | 修改待处理订单 |
cancel_order | 取消待处理订单 |
get_gtt_triggers | 查看触发前的良好订单 |
place_gtt | 设置GTT单触发或OCO（止损+目标）触发 |
关键能力：
- 全自动登录——TOTP即时生成，无需人工干预
- 对过时的令牌自动重试——如果令牌在会话中期过期，则透明地重新进行身份验证
- 支持交付（CNC）、日内（MIS）和F&O（NRML）订单
- 支持售后订单（AMO）
兼容
适用于任何MCP兼容客户端，包括：
| 客户端 | 平台 |
|---|---|
| 克劳德桌面 | macOS、Windows |
| 克劳德代码 | 终端（macOS、Linux、Windows） |
| 光标 | macOS、Windows、Linux |
| 帆板运动 | macOS、Windows、Linux |
| 继续 | VS Code，JetBrains |
| 任何兼容MCP的客户端 | 请参阅 MCP客户端列表 |
快速开始
1.安装
pip install kite-mcp2.获取您的证书
你需要一个 风筝连接 API应用程序。从您的应用程序仪表板中，记录您的 API密钥 和 API秘密.
您还需要：
- 用户ID --您的Zerodha客户端ID（例如AB1234）
- 密码 --您的Zerodha登录密码
- TOTP秘密 （推荐）--为Zerodha 2FA设置外部身份验证器应用程序的base32种子。这实现了完全自动登录，无需手动步骤。
How to get your TOTP secret
- 登录到 console.zerodha.com
- 首选 我的资料 > 安全 > 2FA设置
- 切换到 外部身份验证器应用程序 （谷歌身份验证器、Authy等）
- 当二维码出现时，寻找 “无法扫描？复制此密钥” 链接
- 该密钥是您的TOTP密钥——在完成设置之前保存它
- 输入身份验证器中的6位代码以完成
3.配置您的MCP客户端
将此添加到MCP客户端配置中。配置位置取决于您的客户端——有关确切路径，请参阅客户端的文档。
{
"mcpServers": {
"kite": {
"command": "kite-mcp",
"env": {
"KITE_API_KEY": "your-api-key",
"KITE_API_SECRET": "your-api-secret",
"KITE_USER_ID": "your-user-id",
"KITE_PASSWORD": "your-password",
"KITE_TOTP_SECRET": "your-totp-secret"
}
}
}
}重新启动MCP客户端。你准备好交易了。
4.试试看
打开新聊天室并尝试：
- “显示我的投资组合”
- “塔塔汽车的交易价格是多少？”
- “以市场价格购买10台Infosys”
- “我有多少现金？”
- “取消我上一个待处理的订单”
- “显示我的最大赢家和输家”
人工智能助手可以用简单的英语理解股票名称，无需使用交易符号。
环境变量
| 变量 | 必填 | 描述 |
|---|---|---|
KITE_API_KEY | 是 | Kite Connect API密钥 |
KITE_API_SECRET | 是 | Kite Connect API机密 |
KITE_USER_ID | 是 | Zerodha客户端ID |
KITE_PASSWORD | 是 | Zerodha登录密码 |
KITE_TOTP_SECRET | 没有 | TOTP base32种子用于自动登录。没有这个，你必须跑 kite-mcp-login 每天手动。 |
手动登录
如果你没有TOTP密码，你可以每天手动登录：
export KITE_API_KEY=your-api-key
export KITE_API_SECRET=your-api-secret
export KITE_USER_ID=your-user-id
export KITE_PASSWORD=your-password
kite-mcp-login这将缓存当天剩余时间的访问令牌。MCP服务器将使用缓存的令牌，直到它过期。
用例
- 日常投资组合监控 --“给我一份关于我的投资组合的总结，包括最大的赢家和输家”
- 快速交易 --“买50个信实”/“卖掉我所有的Yes Bank”
- 研究+行动 --“HDFC Bank的52周高点是多少？我应该在目前的水平上增加更多吗？”
- 风险管理 --“将我的BDL头寸的止损GTT设置为1100”
- 预定报告 --结合MCP计划任务，在上午9点获得每日投资组合摘要
- Slack集成 --与Slack MCP配对，在您的Slack频道中接收投资组合警报
路线图
- \[\]F&O交易员的期权链数据
- \[\]篮下订单--在一个命令中下多个订单
- \[\]共同基金工具——购买、赎回、检查SIPs
- \[\]观察名单管理
- \[\]投资组合分析——行业分配、多元化得分
- \[\]对实时价格警报的Webhook/流媒体支持
- \[\]支持多个Zerodha帐户
有主意吗？ 打开功能请求.
发展
git clone https://github.com/aranjan/kite-mcp.git
cd kite-mcp
python -m venv venv
source venv/bin/activate
pip install -e .安全
- 凭据通过环境变量传递，从不存储在代码中
- 访问令牌在本地缓存在
~/.zerodha_kite_token.json每天到期 - 服务器在您的计算机上本地运行，不会向第三方服务器发送任何数据
- 与Zerodha的所有通信都使用HTTPS
许可证
麻省理工学院