Kite Spring MCP Server

Kite Spring MCP 服务

使用 Spring Boot 构建的 Zerodha Kite API Java 实现，作为 Model Context Protocol（MCP）服务。灵感来自官方 Kite MCP 服务项目。

概述

本项目实现了一个基于 Spring 的 Model Context Protocol（MCP）服务，提供用于与 Zerodha 的 Kite 交易平台交互的工具。MCP 是一种协议，可让 AI Agent 以标准化的方式与外部工具和服务交互，从而将其能力扩展到语言生成之外。

该服务在 AI Agent 与 Kite 交易平台之间提供通信桥梁，使 Agent 能够对用户进行身份验证，并通过定义好的工具访问其交易信息。

功能

• 基于 OAuth 的 Zerodha Kite 身份验证
• 用于维护用户上下文的会话管理
• 用于与 Kite API 交互的 MCP 工具

已实现的工具

此概念验证实现提供以下工具：

1. login - 通过 OAuth 向 Zerodha Kite 进行身份验证，并为用户提供登录 URL。
2. get_holdings - 身份验证后获取用户的投资组合持仓。

技术栈

• Spring Boot（v3.2.0）：主要应用框架
• Spring AI MCP WebMVC：实现 Model Context Protocol 服务功能（https://docs.spring.io/spring-ai/reference/api/mcp/mcp-server-boot-starter-docs.html）
• Zerodha Kite Connect SDK（v3.5.0）：用于访问 Zerodha 交易 API 的 Java 客户端（https://github.com/zerodha/javakiteconnect）
• Java 21：目标 JDK 版本

运行服务

前置条件

• Java 21 或更高版本
• Maven
• Zerodha Kite API 凭据

环境变量

需要设置以下环境变量：

KITE_API_KEY=your_kite_api_key
KITE_API_SECRET=your_kite_api_secret

构建和运行

mvn clean package
java -jar target/kite-spring-mcp-1.0-SNAPSHOT.jar

服务默认在 8080 端口启动。

配置 AI Agent

本项目支持 Server-Sent Events（SSE），用于与实现 MCP 协议的 AI Agent 通信。

在 VS Code 中使用

要在 VS Code 中使用此 MCP 服务，请添加以下配置：

全局 settings.json

"mcp": {
    "servers": {
        "kite_java": {
            "type": "sse",
            "url": "http://localhost:8080/mcp/sse"
        }
    }
},

工作区 mcp.json

或者，也可以在工作区级别添加配置：

"servers": {
    "kite_java": {
        "type": "sse",
        "url": "http://localhost:8080/mcp/sse"
    }
}

扩展服务

此实现旨在便于通过以下方式扩展更多 Kite API 工具：

1. 在 io.github.kartikhub.tool 包中创建新的工具类
2. 使用 @Tool 注解将方法公开为 MCP 工具
3. 在 ToolConfig 类中注册这些工具

许可证

本项目依据 MIT 许可证发布。详情请参阅 LICENSE 文件。

此实现的灵感来自 Zerodha Tech 的官方 Kite MCP 服务，该项目同样采用 MIT 许可证。归属信息见 THIRD_PARTY_LICENSES 文件。