NSE Ticker MCP Server

NSE Ticker MCP Server

Un servidor del Protocolo de Contexto de Modelo (MCP) que proporciona acceso a los datos de la Bolsa Nacional de Valores (NSE) a través de la API de Upstox.

Herramientas

El servidor expone las siguientes herramientas a través del Protocolo de Contexto de Modelo:

Datos históricos

Herramienta	Descripción
get_historical_candle	Obtén datos históricos OHLCV (Apertura, Máximo, Mínimo, Cierre, Volumen) para acciones de NSE

Características

• Acceso a datos de acciones de NSE en tiempo real
• Soporte de múltiples intervalos de tiempo (minuto, 30 minutos, día, semana, mes)
• Manejo de errores y validación de datos
• Datos históricos de precios con rangos de fechas personalizables

Requisitos

• Python 3.11 o superior
• Dependencias (especificadas en pyproject.toml):
  • mcp
  • pandas
  • httpx
  • pydantic

Instalación

1. Clona este repositorio:

git clone https://github.com/sougatabh/nse-ticker-mcp.git
cd nse-ticker-mcp

2. Crea y activa un entorno virtual:

python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

3. Instala las dependencias:

pip install -e .

Uso

Modo de desarrollo

Prueba el servidor con MCP Inspector:

python ticker.py

Integración con Claude for Desktop

1. Instala Claude for Desktop

2. Edita el archivo de configuración de Claude:

MacOS:

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

Añade la siguiente configuración:

{
  "mcpServers": {
    "nse-ticker": {
      "command": "python",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/nse-ticker-mcp",
        "ticker.py"
      ]
    }
  }
}

Ejemplo de uso

# Get historical data for HDFC Bank
response = await get_historical_candle(
    symbol="HDFCBANK",
    from_date="2024-01-01",
    to_date="2024-03-31",
    interval="day"
)

Intervalos disponibles

• minute - Velas de 1 minuto
• 30minute - Velas de 30 minutos
• day - Velas diarias
• week - Velas semanales
• month - Velas mensuales

Manejo de errores

El servidor proporciona mensajes de error detallados para:

• Símbolos no válidos
• Problemas de conexión
• Errores de API
• Fallos de validación de datos
• Problemas de formato de fecha

Configuración

Los símbolos de acciones y las claves de instrumentos se configuran en:

• configs/NSE.csv

Licencia

Licencia MIT

Contribuciones

1. Haz un fork del repositorio
2. Crea tu rama de características
3. Envía un pull request