kite-mcp 是用于 Zerodha Kite 的 MCP 服务器，目标是通过任何兼容 MCP 的 AI 助手，以自然对话的方式交易印度股票。与传统 Kite Python 封装库需要编写代码不同，kite-mcp 让用户直接对话即可完成交易，无需代码、脚本或终端。
用途： kite-mcp 将兼容 MCP 的 AI 助手直接连接到用户的 Zerodha 账户，提供 14 个交易工具、自动化 TOTP 登录以及令牌过期时的自动重试。AI 助手会解析用户意图，将股票名称映射为交易代码（例如将 “Infosys” 映射为 NSE:INFY），检查资金并执行交易，整个过程通过 MCP 协议完成。服务器自动处理认证，包括通过 TOTP 每日刷新令牌。
主要能力：
- 14 个交易工具，提供完整的交易控制。
- 全自动登录：动态生成 TOTP，无需人工干预。
- 令牌过期自动重试：如果令牌在会话中途过期，会透明地重新认证。
- 支持交割（CNC）、日内（MIS）和 F&O（NRML）订单。
- 支持盘后订单（AMO）。
- 兼容任何 MCP 兼容客户端。
- AI 助手理解纯英文股票名称，无需使用交易代码。
- 提供环境变量配置，支持手动登录备选方案。
- 凭据通过环境变量传递，不存储在代码中。
- 访问令牌本地缓存在 ~/.zerodha_kite_token.json，每日过期。
- 服务器在用户本地机器上运行，不向第三方服务器发送数据。
- 与 Zerodha 的所有通信均使用 HTTPS。
使用方式： 要使用 kite-mcp，首先需要获取 Kite Connect API 应用，从应用仪表盘记下 API Key 和 API Secret。然后准备以下凭据：
- User ID：Zerodha 客户 ID（例如 AB1234）。
- Password：Zerodha 登录密码。
- TOTP Secret（推荐）：来自为 Zerodha 双因素认证设置的外部验证器应用的 base32 种子。这能实现完全自动化登录，无需手动步骤。获取方式：登录 console.zerodha.com，进入 My Profile > Security > 2FA Settings，切换到外部验证器应用（如 Google Authenticator、Authy），在出现二维码时找到 “Can't scan? Copy this key” 链接，该密钥即为 TOTP secret，在完成设置前保存，然后输入验证器中的 6 位代码完成设置。 接下来配置 MCP 客户端：将相应配置添加到 MCP 客户端配置中（配置位置取决于客户端，需参考对应客户端文档）。重启 MCP 客户端后即可交易。 之后可以打开新对话尝试以下指令：
- “Show my portfolio holdings”（显示我的投资组合持仓）
- “What's Tata Motors trading at?”（塔塔汽车现在什么价？）
- “Buy 10 Infosys at market price”（以市价买入 10 股 Infosys）
- “How much cash do I have available?”（我可用现金有多少？）
- “Cancel my last pending order”（取消我最后一个待处理订单）
- “Show my top gainers and losers”（显示我的涨幅榜和跌幅榜）
如果没有 TOTP secret，可以每天手动登录：这种方式会缓存当天剩余时间的访问令牌，MCP 服务器将使用缓存令牌直到过期。
适用场景：
- 每日投资组合监控：“给我一份包含涨幅榜和跌幅榜的投资组合摘要”。
- 快速交易：“买入 50 股 Reliance” 或 “卖出我全部 Yes Bank”。
- 研究加操作：“HDFC Bank 的 52 周最高价是多少？在当前价位我应该加仓吗？”
- 风险管理：“为我的 BDL 持仓设置 1100 的止损 GTT”。
- 定时报告：结合 MCP 定时任务，在上午 9 点获取每日投资组合摘要。
- Slack 集成：与 Slack MCP 配合，在 Slack 频道接收投资组合提醒。
限制与暂未提供的信息： 资料中列出了部分未来规划功能，包括 F&O 交易者的期权链数据、篮子订单（一条指令下多个订单）、共同基金工具（购买、赎回、查询 SIP）、自选列表管理、投资组合分析（行业配置、分散度评分）、实时价格提醒的 webhook/流式支持、多 Zerodha 账户支持。这些属于计划中的功能请求方向，并非当前已具备的能力。资料未提供具体的收费标准、价格、支持的完整客户端列表、安装命令细节或平台兼容性信息。安全策略方面，仅提及凭据通过环境变量传递、令牌本地缓存、本地运行和 HTTPS 通信。
