N.I.N.A. Advanced API

Control the N.I.N.A. (Nighttime Imaging 'N' Astronomy) software through its Advanced API.

GitHub

MseeP.ai Security Assessment Badge

Nina_advanced_api_mcp

Interface for AI agents to use your astrophotography setup using N.I.N.A (Beta)

N.I.N.A Model Context Protocol Server for Advanced API Plugin v2 (MCP)

A powerful interface for controlling N.I.N.A. (Nighttime Imaging 'N' Astronomy) software through its Advanced API NINA Advanced API . This Model Context Protocol Server (MCP) enables AI agents to interact with NINA using tools, providing new way to interact with your setup. Usage with your own responsibility.

License: MIT Python 3.8+ NINA

🌟 Features

  • Complete Equipment Control for AI agents

    • Cameras (capture, cooling, settings, connecting ....)
    • Mounts (slewing, parking, tracking...)
    • Focusers (movement, temperature compensation ... )
    • Filter Wheels (filter selection, info ...)
    • Domes (rotation, shutter control ...)
    • Rotators (movement, sync...)
    • ...

  • AI Integration

    • Natural language command processing
    • Contextual help system
    • Intelligent error responses
    • Automated decision making

  • **Most of the NINA advanced API v2 api interface endpoints supported

🚀 Quick Start

Prerequisites

  • Python 3.8 or higher
  • NINA software with Advanced API plugin
  • uv package manager
  • AI agent with MCP support (e.g., Claude)

Installation

  1. Install NINA Advanced API Plugin

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

  2. Clone Repository

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

  3. Set Environment Variables

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

Configuration

MCP Server Setup

Add to your AI agent's MCP configuration:

{
  "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"
      }
    }
  }
}

📚 Usage

Basic AI Examples with Claude Destop

  • Connect to nina
  • read the setup
  • connect my camera, mount, filter wheel and guider
  • read the sequesces and let me select the sequence to start

AI Agent Commands

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

📖 API Documentation

Core Modules

Equipment Control

  • Camera operations
  • Mount control
  • Focuser management
  • Filter wheel control
  • Dome automation
  • Rotator functions

Imaging

  • Capture configuration
  • Image processing
  • File management
  • Statistics gathering

System

  • Connection handling
  • Status monitoring
  • Error management
  • Configuration

🤝 Contributing

Contributions are welcome! Please read our Contributing Guidelines first.

  1. Fork the repository
  2. Create your feature branch
  3. Commit your changes
  4. Push to the branch
  5. Create a Pull Request

🐛 Bug Reports

Found a bug? Please open an issue with:

  • Detailed description
  • Steps to reproduce
  • Expected vs actual behavior
  • System information

📜 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

🔗 Related Projects

Serveurs connexes