N.I.N.A. Advanced API

Controla el software N.I.N.A. (Nighttime Imaging 'N' Astronomy) a través de su Advanced API.

GitHub
12
Prueba este MCPPatrocinado

Documentación

MseeP.ai Security Assessment Badge

Nina_advanced_api_mcp

Interfaz para que agentes de IA utilicen tu configuración de astrofotografía usando N.I.N.A (Beta)

Servidor de Protocolo de Contexto de Modelo N.I.N.A para el Plugin de API Avanzada v2 (MCP)

Una interfaz potente para controlar el software N.I.N.A. (Nighttime Imaging 'N' Astronomy) a través de su API Avanzada NINA Advanced API. Este Servidor de Protocolo de Contexto de Modelo (MCP) permite a los agentes de IA interactuar con NINA usando herramientas, proporcionando una nueva forma de interactuar con tu configuración. El uso es bajo tu propia responsabilidad.

License: MIT Python 3.8+ NINA

🌟 Características

  • Control completo del equipo para agentes de IA

    • Cámaras (captura, enfriamiento, ajustes, conexión...)
    • Monturas (apuntado, estacionamiento, seguimiento...)
    • Enfocadores (movimiento, compensación de temperatura...)
    • Ruedas de filtros (selección de filtros, información...)
    • Cúpulas (rotación, control de obturador...)
    • Rotadores (movimiento, sincronización...)
    • ...

  • Integración de IA

    • Procesamiento de comandos en lenguaje natural
    • Sistema de ayuda contextual
    • Respuestas de error inteligentes
    • Toma de decisiones automatizada

  • **Soporte para la mayoría de los endpoints de la interfaz de la API Avanzada v2 de NINA

🚀 Inicio Rápido

Requisitos Previos

  • Python 3.8 o superior
  • Software NINA con el plugin de API Avanzada
  • uv gestor de paquetes
  • Agente de IA con soporte MCP (por ejemplo, Claude)

Instalación

  1. Instalar el Plugin de API Avanzada de NINA

    # Install the plugins in NINA
# Enable and configure in NINA settings

  2. Clonar el Repositorio

    git clone https://github.com/PaDev1/Nina_advanced_api_mcp.git
cd nina-mcp

  3. Configurar Variables de Entorno

    # Create .env file
NINA_HOST=your_nina_host
NINA_PORT=1888
LOG_LEVEL=INFO
IMAGE_SAVE_DIR=~/Desktop/NINA_Images

Configuración

Configuración del Servidor MCP

Añade a la configuración MCP de tu agente de IA:

{
  "mcpServers": {
    "nina_advanced_mcp_api": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "fastmcp,fastapi,uvicorn,pydantic,aiohttp,requests,python-dotenv",
        "fastmcp",
        "run",
        "path/nina_advanced_mcp.py"
      ],
      "env": {
        "NINA_HOST": "NINA_IP",
        "NINA_PORT": "1888",
        "LOG_LEVEL": "INFO",
        "IMAGE_SAVE_DIR": "~/Desktop/NINA_Images"
      }
    }
  }
}

📚 Uso

Ejemplos Básicos de IA con Claude Desktop

  • Conectar a nina
  • leer la configuración
  • conectar mi cámara, montura, rueda de filtros y guiador
  • leer las secuencias y déjame seleccionar la secuencia para iniciar

Comandos del Agente de IA

- "Take a 30-second exposure of M31"
- "Connect all equipment and start cooling the camera to -10°C"
- "Start a sequence targeting NGC 7000"
- "Get the current equipment status"

📖 Documentación de la API

Módulos Principales

Control de Equipo

  • Operaciones de cámara
  • Control de montura
  • Gestión de enfocador
  • Control de rueda de filtros
  • Automatización de cúpula
  • Funciones de rotador

Imágenes

  • Configuración de captura
  • Procesamiento de imágenes
  • Gestión de archivos
  • Recopilación de estadísticas

Sistema

  • Gestión de conexiones
  • Monitoreo de estado
  • Gestión de errores
  • Configuración

🤝 Contribuciones

¡Las contribuciones son bienvenidas! Por favor, lee primero nuestras Directrices de Contribución.

  1. Haz un fork del repositorio
  2. Crea tu rama de características
  3. Realiza tus cambios
  4. Haz push a la rama
  5. Crea una Solicitud de Extracción (Pull Request)

🐛 Informes de Errores

¿Encontraste un error? Por favor, abre un issue con:

  • Descripción detallada
  • Pasos para reproducir
  • Comportamiento esperado vs. real
  • Información del sistema

📜 Licencia

Este proyecto está licenciado bajo la Licencia MIT - consulta el archivo LICENSE para más detalles.

🙏 Agradecimientos

🔗 Proyectos Relacionados