N.I.N.A. Advanced API

Controle o software N.I.N.A. (Nighttime Imaging 'N' Astronomy) através de sua Advanced API.

GitHub
12
Experimente este MCPPatrocinado

Documentação

MseeP.ai Security Assessment Badge

Nina_advanced_api_mcp

Interface para agentes de IA usarem sua configuração de astrofotografia usando N.I.N.A (Beta)

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

Uma interface poderosa para controlar o software N.I.N.A. (Nighttime Imaging 'N' Astronomy) através de sua Advanced API NINA Advanced API. Este Servidor de Protocolo de Contexto de Modelo (MCP) permite que agentes de IA interajam com o NINA usando ferramentas, proporcionando uma nova maneira de interagir com sua configuração. Uso por sua própria responsabilidade.

License: MIT Python 3.8+ NINA

🌟 Recursos

  • Controle Completo de Equipamentos para agentes de IA

    • Câmeras (captura, resfriamento, configurações, conexão...)
    • Montagens (movimentação, estacionamento, rastreamento...)
    • Focalizadores (movimento, compensação de temperatura...)
    • Rodas de filtros (seleção de filtros, informações...)
    • Cúpulas (rotação, controle de obturador...)
    • Rotadores (movimento, sincronização...)
    • ...

  • Integração com IA

    • Processamento de comandos em linguagem natural
    • Sistema de ajuda contextual
    • Respostas inteligentes a erros
    • Tomada de decisão automatizada

  • **A maioria dos endpoints da interface da API avançada v2 do NINA é suportada

🚀 Início Rápido

Pré-requisitos

  • Python 3.8 ou superior
  • Software NINA com plugin Advanced API
  • Gerenciador de pacotes uv
  • Agente de IA com suporte a MCP (ex.: Claude)

Instalação

  1. Instale o Plugin Advanced API do NINA

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

  2. Clone o Repositório

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

  3. Defina as Variáveis de Ambiente

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

Configuração

Configuração do Servidor MCP

Adicione à configuração MCP do seu 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

Exemplos Básicos de IA com Claude Desktop

  • Conecte-se ao nina
  • leia a configuração
  • conecte minha câmera, montagem, roda de filtros e guiador
  • leia as sequências e deixe-me selecionar a sequência para iniciar

Comandos do 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"

📖 Documentação da API

Módulos Principais

Controle de Equipamentos

  • Operações de câmera
  • Controle de montagem
  • Gerenciamento de focalizador
  • Controle de roda de filtros
  • Automação de cúpula
  • Funções de rotador

Imagem

  • Configuração de captura
  • Processamento de imagem
  • Gerenciamento de arquivos
  • Coleta de estatísticas

Sistema

  • Gerenciamento de conexão
  • Monitoramento de status
  • Gerenciamento de erros
  • Configuração

🤝 Contribuindo

Contribuições são bem-vindas! Por favor, leia nossas Diretrizes de Contribuição primeiro.

  1. Faça um fork do repositório
  2. Crie sua branch de recurso
  3. Faça commit das suas alterações
  4. Envie para a branch
  5. Crie um Pull Request

🐛 Relatórios de Bugs

Encontrou um bug? Por favor, abra uma issue com:

  • Descrição detalhada
  • Passos para reproduzir
  • Comportamento esperado vs. real
  • Informações do sistema

📜 Licença

Este projeto é licenciado sob a Licença MIT - veja o arquivo LICENSE para detalhes.

🙏 Agradecimentos

🔗 Projetos Relacionados