使用说明

项目简介

Zerodha Kite MCP服务器是一个基于Model Context Protocol (MCP) 构建的应用后端，它集成了Zerodha Kite这一流行的印度股票经纪平台。通过这个服务器，LLM客户端能够以标准化的方式访问Zerodha Kite的市场数据、管理交易订单并在Zerodha Kite平台上执行交易操作。

主要功能点

市场数据访问: 获取实时的和历史的市场数据，包括股票报价、OHLC（开盘价、最高价、最低价、收盘价）、最新成交价(LTP)等。
账户信息查询: 检索用户的账户信息，如订单列表、交易记录、持仓信息、资金账户信息（保证金）、用户资料等。
交易订单管理: 管理股票交易订单，包括下单、修改订单、取消订单，以及设置有效期较长的GTT (Good Till Triggered) 订单。
篮子委托保证金计算: 计算一组订单的篮子委托所需的保证金。
Zerodha Kite API集成: 无缝对接Zerodha Kite API，将Kite平台的功能以MCP资源和工具的形式暴露出来。
用户认证和会话管理: 支持通过API密钥和Access Token进行用户身份验证和会话管理。

安装步骤

环境准备: 确保已安装 Python 3.6 或更高版本，以及包管理工具 pip。

克隆仓库: 使用 git 命令克隆 Zerodha Kite MCP 服务器仓库到本地：

git clone https://github.com/rhnvrm/kite-mcp-server.git

进入项目目录: 切换到克隆下来的仓库目录：
```
cd kite-mcp-server
```

安装依赖: 使用 pip 安装项目所需的 Python 依赖库：

pip install fastmcp kiteconnect pydantic httpx

服务器配置

MCP客户端需要配置以下 JSON 格式的信息来连接 Zerodha Kite MCP 服务器：

{
  "server_name": "zerodha-kite-mcp",  // MCP服务器的名称，可以自定义
  "command": "python",                 // 启动服务器的命令，这里使用 python
  "args": ["server.py"],              // 启动命令的参数，指定服务器脚本为 server.py
  "transport": "stdio"                // 使用 stdio 作为传输协议
}

'server_name': 为您的 MCP 服务器实例指定一个易于识别的名称。
'command': 运行服务器端代码的命令，通常是 Python 解释器 'python'。
'args': 传递给 'command' 的参数列表，这里指定执行 'server.py' 脚本。
'transport': MCP客户端与服务器通信的传输协议，'stdio' 表示标准输入输出流。

基本使用方法

启动服务器: 在 MCP 客户端中配置好上述服务器配置信息后，启动 Zerodha Kite MCP 服务器。服务器将通过标准输入输出流等待接收 MCP 客户端的请求。
身份验证:
- 调用 'login_url' 工具，并传入您的 Zerodha API Key。该工具会返回一个登录 URL。
- 打开返回的 URL，完成 Zerodha Kite 的登录认证流程，认证成功后您会获得一个 request token。
- 调用 'set_access_token' 工具，并传入上一步获取的 request token 和您的 API Secret，完成 Access Token 的设置。
访问资源和调用工具: 使用 MCP 客户端发送请求，访问 'kite://orders', 'kite://positions' 等资源以获取市场或账户数据，或调用 'place_order', 'get_quote' 等工具执行交易操作或获取实时行情。请参考代码中定义的资源和工具列表及其参数来构建您的请求。

关键词