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: Kite MCP Server

Prerrequisitos

• Node.js (v14 o superior)

• Cuenta de trading de Zerodha

• Credenciales API de Zerodha

Instalación

1. Clonar el repositorio:

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

2. Instalar dependencias:

npm install

3. 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:

1. Abra claude_desktop_config.json en la raíz de su proyecto

2. 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.