AI导哈

交易工具服务器

一个基于Zerodha Kite Connect JavaScript SDK的TypeScript MCP服务器，提供程序化交易、订单管理和投资组合访问功能。

  • by karthikrajask
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 karthikrajask/Zerodha_MCP_Server

使用说明

交易MCP服务器（Kite Connect）

这是一个TypeScript中的模型上下文协议（MCP）服务器，它使用官方的Zerodha Kite Connect JavaScript SDK公开交易工具。它支持通过MCP工具进行程序化交易、订单管理和投资组合访问。

特性

  • 交易工具：使用Kite Connect进行身份验证、下单、取单和查看持仓。
  • 连接到代理生成器：与MCP Agent Builder集成以进行测试和调试。
  • 使用MCP检查器进行调试：使用MCP Inspector交互式测试和调试所有交易工具。

入门指南

先决条件：

  • Node.js
  • Zerodha Kite Connect API密钥和秘密

设置：

  1. 克隆此存储库并安装依赖项：
    npm install
npm run build
  2. 复制 .env.example 到 .env 并填写您的Kite API证书：
    KITE_API_KEY=your_api_key_here
KITE_API_SECRET=your_api_secret_here
KITE_REDIRECT_URI=http://localhost:3456/kite/callback
  3. 启动MCP服务器：
    npm run dev:http   # HTTP transport (for Inspector)
npm run dev:stdio  # STDIO transport (for Agent Builder)

包含什么

文件夹/文件 内容
.vscode VSCode调试配置
.aitk AI工具包配置
src 交易MCP服务器的源代码
.env.example 环境变量文件示例

调试和测试

您可以使用以下命令调试和测试服务器：

  • 代理构建器：通过STDIO连接以进行本地工具测试。
  • MCP检查员：通过HTTP连接，用于交互式工具调用和调试。

所有调试模式都支持工具实现代码中的断点。

MCP工具（风筝连接）

以下工具已注册，可通过MCP使用：

  • kite_get_login_url：返回用于用户身份验证的登录URL。输入：可选 redirect_uri.
  • kite_generate_session：交易所a request_token 获取访问令牌和会话详细信息。输入： request_token.
  • kite_get_orders：获取所有用户订单。输入： access_token.
  • kite_place_order：下新订单。输入： access_token, exchange, tradingsymbol, transaction_type, quantity，可选 order_type, product, price.
  • kite_get_holdings：获取用户持有量。输入： access_token.

示例流程

  1. 呼叫 kite_get_login_url 并在浏览器中打开返回的URL。登录后，Zerodha会重定向到您的 redirect_uri 带着一个 request_token.
  2. 呼叫 kite_generate_session 随着 request_token 为了得到一个 access_token.
  3. 使用 access_token 在 kite_get_orders, kite_place_order，以及 kite_get_holdings.

安全说明： 将访问令牌视为机密。对于生产，安全地存储令牌，永远不要在日志或客户端代码中公开它们。

定制

您可以在中更改端口和参数 .vscode/tasks.json, src/index.ts, .aitk/mcp.json，以及 .inspector.json 根据需要。

反馈

如果您有任何反馈或建议，请在 AI工具包GitHub存储库

相关 MCP