Kite MCP Server

Kite MCP 服务

一个用于与 Zerodha Kite API 集成的模型上下文协议（MCP）服务。此服务为 Claude 提供工具，以便与您的 Kite 交易账户交互。

功能

• 投资组合管理：获取持仓、资产和订单
• 市场数据：实时行情、LTP 和工具数据
• 订单管理：下单、修改和取消订单
• 账户信息：个人资料、保证金和身份验证状态
• 安全身份验证：支持令牌持久化的 OAuth 2.0 流程

先决条件

1. Zerodha Kite Connect 应用：在 Kite Connect 创建应用
2. API 凭据：获取您的 API Key 和 Secret
3. Bun：最新版本的 Bun 运行时

安装

1. 克隆并安装依赖项：

bun install

2. 设置环境变量：

# Edit .env with your API credentials

3. 使用重定向 URL 配置您的 Kite Connect 应用：

http://localhost:50000/zerodha/auth/redirect

快速开始

1. 使用 Kite API 进行身份验证

bun run auth

此操作将：

• 启动本地 OAuth 服务
• 在浏览器中打开 Kite 登录页面
• 安全地保存您的访问令牌

2. 启动 MCP 服务

bun start

3. 配置 Claude Desktop

将以下内容添加到您的 Claude Desktop 配置中：

{
  "mcpServers": {
    "kite": {
      "command": "bun",
      "args": ["run", "/path/to/kite-mcp/src/index.ts"]
    }
  }
}

可用工具

投资组合工具

• get_profile - 获取用户个人资料信息
• get_positions - 获取当前交易持仓
• get_holdings - 获取长期持有资产
• get_margins - 获取账户保证金和资金

订单工具

• get_orders - 获取今日订单
• place_order - 下达新交易订单
• cancel_order - 取消现有订单

市场数据工具

• get_ltp - 获取工具的最新成交价
• get_quote - 获取详细市场行情
• get_instruments - 获取可交易工具列表

实用工具

• get_auth_status - 检查身份验证状态

项目结构

src/
├── config/
│   └── environment.ts          # Configuration management
├── auth/
│   ├── token-manager.ts        # Token storage and validation
│   └── oauth-server.ts         # OAuth flow handling
├── api/
│   └── kite-client.ts          # Kite API wrapper
├── mcp/
│   ├── server.ts               # MCP server implementation
│   └── tools/
│       └── index.ts            # MCP tools definitions
├── auth.ts                     # Authentication entry point
└── index.ts                    # MCP server entry point

开发

构建（可选）

bun run build

开发模式

bun run dev          # Watch mode for MCP server
bun run dev:auth     # Watch mode for auth server

架构

项目遵循单一职责原则：

• ConfigManager：处理环境和配置
• TokenManager：令牌持久化和验证
• OAuthServer：OAuth 2.0 身份验证流程
• KiteClient：带错误处理的 Kite API 封装
• KiteMCPServer：MCP 协议实现
• Tools：各个 MCP 工具的实现

环境变量

API_KEY=your_kite_api_key        # Required: Kite Connect API Key
API_SECRET=your_kite_api_secret  # Required: Kite Connect API Secret
OAUTH_PORT=50000                 # Optional: OAuth server port (default: 50000)

安全性

• 令牌存储在本地的 access_token.json 中
• OAuth 流程使用安全的重定向处理
• API 凭据绝不会被记录或泄露
• 令牌会自动过期以确保安全

故障排除

身份验证问题

1. 验证 .env 中的 API 凭据
2. 检查 Kite Connect 应用设置中的重定向 URL
3. 确保 OAuth 端口（50000）可用

令牌过期

• Kite 令牌每隔约 6 小时过期
• 令牌过期后重新运行 bun run auth
• 服务会通知您身份验证状态

MCP 连接问题

1. 验证 Claude Desktop 配置
2. 检查服务是否正在运行：bun start
3. 查看 Claude Desktop 日志中的错误

贡献

1. Fork 此代码库
2. 创建功能分支
3. 遵循现有的代码结构和模式
4. 添加适当的错误处理
5. 提交拉取请求

许可证

MIT 许可证 - 详情请参阅 LICENSE 文件

免责声明

这是与 Zerodha Kite API 的非官方集成。使用风险自负。执行前请务必核实交易和订单。