mcpField
Z
Zerodha MCP Integration

Zerodha MCP Integration

本地服务
github.com/aptro金融数据4681 周前更新
代码仓库

关于 Zerodha MCP Integration

Zerodha MCP Integration 是一个 MCP 服务，用于通过 Zerodha Kite Connect API 访问股票与共同基金交易账户。它面向希望在 Claude 中查询账户并执行交易操作的用户。

主要功能

  1. 01查询账户保证金、持仓与仓位
  2. 02获取报价与历史行情数据
  3. 03下达股票及共同基金订单
  4. 04管理共同基金 SIP（新建、修改、取消）
  5. 05本地完成 Zerodha 登录与令牌存储

适用场景

  1. 01在 Claude 中查看投资组合和账户保证金
  2. 02通过自然语言查询报价或历史价格
  3. 03管理共同基金定投计划

MCP 相关

该项目是一个 MCP 服务，向 MCP 客户端（如 Claude Desktop）暴露账户查询、下单和 SIP 管理等工具。认证流程在本地启动服务并打开浏览器登录。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "zerodha": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli"
      ]
    }
  }
}
启动命令npx -y @smithery/cli

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@smithery/cli

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

Zerodha MCP 集成

smithery badge

此项目使用 Multi-Cloud Plugin（MCP）框架，将 Zerodha 的交易平台与 Claude AI 集成，让你可以通过 Claude 直接与 Zerodha 交易账户交互。

设置说明

通过 Smithery 安装

要通过 Smithery 自动为 Claude Desktop 安装 zerodha-mcp：

npx -y @smithery/cli install @aptro/zerodha-mcp --client claude
1. 创建 Zerodha 开发者账户
  1. 前往 Kite Connect 并注册开发者账户
  2. 在 developers.kite.trade 登录账户
2. 创建新应用
  1. 在 Kite Developer 控制台中进入“Apps”部分
  2. 点击“Create a new app”
  3. 填写所需信息：
    • 应用名称：选择一个描述性名称（例如，“Claude Zerodha Integration”）
    • 应用类别：选择“Personal”或适当的类别
    • 重定向 URL：设置为 http://127.0.0.1:5000/zerodha/auth/redirect
    • 描述：简要说明应用的用途
  4. 提交表单以创建应用
3. 获取 API 凭据

创建应用后，你将收到：

  • API Key（也称为 Consumer Key）
  • API Secret（也称为 Consumer Secret）

这些凭据会显示在应用详情页面中。

4. 配置环境变量
  1. 在此项目的根目录中创建 .env 文件
  2. 将 API 凭据添加到文件中：
KITE_API_KEY=your_api_key_here
KITE_API_SECRET=your_api_secret_here

将 your_api_key_here 和 your_api_secret_here 替换为第 3 步中获得的实际凭据。

5. 安装依赖项

确保已安装所有必需的依赖项：

uv pip install kiteconnect fastapi uvicorn python-dotenv httpx
6. 在 Claude 桌面应用中安装 MCP 配置

在 Claude 桌面应用中安装 MCP 配置：

mcp install main.py

此命令会将 Zerodha 插件注册到 Claude，使 AI 能够使用所有交易功能。

使用方法

设置完成后，你可以通过 Claude 使用以下功能与 Zerodha 账户交互：

身份验证
Can you please check if I'm logged into my Zerodha account and authenticate if needed?
股票和常规交易
  • 查看账户保证金：What are my current margins on Zerodha?
  • 查看投资组合持仓：Show me my current holdings on Zerodha
  • 查看当前仓位：What positions do I currently have open on Zerodha?
  • 获取股票代码报价：What's the current price of RELIANCE and INFY on NSE?
  • 下单：Place a buy order for 10 shares of INFY at market price on NSE
  • 获取历史数据：Can you show me the historical price data for SBIN for the last 30 days?
共同基金
  • 查看共同基金持仓：Show me my mutual fund holdings on Zerodha
  • 获取共同基金订单：List all my mutual fund orders on Zerodha
  • 下共同基金订单：Place a buy order for ₹5000 in the mutual fund with symbol INF090I01239
  • 取消共同基金订单：Cancel my mutual fund order with order ID 123456789
  • 查看 SIP 详情：Show all my active SIPs on Zerodha
  • 创建新的 SIP：Set up a monthly SIP of ₹2000 for the fund with symbol INF090I01239 for 12 installments
  • 修改现有 SIP：Change my SIP with ID 987654321 to ₹3000 per month
  • 取消 SIP：Cancel my SIP with ID 987654321
  • 浏览可用共同基金：Show me a list of available mutual funds on Zerodha

身份验证流程

首次使用任何 Zerodha 功能时，Claude 将：

  1. 在端口 5000 上启动本地服务
  2. 打开浏览器窗口以登录 Zerodha
  3. 登录成功后，保存访问令牌以供后续会话使用

会话将保持有效，直到令牌过期（通常为 24 小时）。令牌过期后，Claude 会自动重新启动登录流程。

可用的 MCP 工具

此插件提供以下 Claude 可使用的 MCP 工具：

身份验证
  • check_and_authenticate - 验证身份验证状态，并在需要时启动登录
  • initiate_login - 启动 Zerodha 登录流程
  • get_request_token - 登录后获取请求令牌
股票/常规交易
  • get_holdings - 获取投资组合持仓
  • get_positions - 获取当前持仓
  • get_margins - 获取账户保证金
  • place_order - 下达交易订单
  • get_quote - 获取指定代码的行情
  • get_historical_data - 获取历史价格数据
共同基金
  • get_mf_orders - 获取共同基金订单
  • place_mf_order - 下达共同基金订单
  • cancel_mf_order - 取消共同基金订单
  • get_mf_instruments - 获取可用的共同基金工具
  • get_mf_holdings - 获取共同基金持仓
  • get_mf_sips - 获取有效的 SIP
  • place_mf_sip - 创建新的 SIP
  • modify_mf_sip - 修改现有 SIP
  • cancel_mf_sip - 取消 SIP

故障排除

  • 如果遇到身份验证问题，请尝试删除 .tokens 文件并重新启动身份验证流程
  • 确保 .env 文件中的 Zerodha 凭据正确
  • 确保端口 5000 未被其他应用程序占用
  • 如果问题持续存在，请在 status.zerodha.com 查看 Zerodha 的 API 状态

安全说明

  • 你的 Zerodha API 凭据仅存储在本地 .env 文件中
  • 访问令牌存储在项目目录中的 .tokens 文件内
  • 不会向 Claude 或任何第三方传输凭据
  • 所有身份验证均直接在你与 Zerodha 的服务器之间进行

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。