Zerodha Trading MCP

Un servidor de Protocolo de Contexto de Modelo (MCP) que permite que los modelos de IA interactúen con la plataforma de trading Zerodha. Este proyecto proporciona un conjunto de herramientas para ejecutar operaciones, visualizar la cartera y gestionar posiciones en Zerodha mediante una interfaz estandarizada.

Características

🔐 Autenticación segura con la API de Zerodha
📊 Ver las tenencias de la cartera
📈 Consultar posiciones abiertas
💹 Realizar órdenes de compra/venta
👤 Acceder a la información del perfil de usuario

Related MCP server: Monad MCP Server

Prerrequisitos

Node.js (v14 o superior)
Cuenta de trading de Zerodha
Credenciales API de Zerodha

Instalación

Clonar el repositorio:

git clone https://github.com/shubhamprajapati7748/zerodha-trade-mcp.git cd zerodha-trade-mcp

Instalar dependencias:

npm install

Cree un archivo .env en el directorio raíz con sus credenciales de Zerodha:

KITE_API_KEY=your_api_key KITE_SECRET_KEY=your_secret_key REQUEST_TOKEN=your_request_token ACCESS_TOKEN=your_access_token

Configuración de MCP de Claude Desktop

Para usar este servidor MCP con Claude Desktop, debe configurar los detalles del servidor MCP. A continuación, le explicamos cómo configurarlo:

Abra claude_desktop_config.json en la raíz de su proyecto
Agregue la siguiente configuración:

{ "mcpServers": { "tradeStocks": { "command": "/opt/homebrew/bin/bun", "args": [ "/path/to/your/index.ts" ], "env": { "KITE_API_KEY": "your_api_key", "KITE_SECRET_KEY": "your_secret_key", "REQUEST_TOKEN": "your_request_token", "ACCESS_TOKEN": "your_access_token" } } } }

Asegúrese de:

Actualice la ruta a su archivo index.ts
Reemplace las variables de entorno con sus credenciales reales de Zerodha

Uso

El servidor MCP proporciona las siguientes herramientas:

Obtener perfil

get-profile

Recupera la información del perfil del usuario de Zerodha.

Comprar acciones

buy-stock {stock: string, quantity: number}

Realiza una orden de compra para el stock y cantidad especificados.

Vender acciones

sell-stock {stock: string, quantity: number}

Realiza una orden de venta para el stock y cantidad especificados.

Mostrar portafolio

show-portfolio

Muestra la cartera completa de inversiones del usuario.

Mostrar posiciones

show-positions

Muestra las posiciones abiertas del usuario.

Desarrollo

El proyecto se construye utilizando:

Mecanografiado
API de KiteConnect
SDK del Protocolo de Contexto de Modelo (MCP)
Zod para la validación de esquemas

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

Descargo de responsabilidad

Este proyecto es solo para fines educativos. Operar en los mercados financieros conlleva un riesgo significativo. Investigue siempre por su cuenta y opere con responsabilidad.