Nina Advanced API MCP

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.

🌟 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

Install NINA Advanced API Plugin
# Install the plugins in NINA # Enable and configure in NINA settings
Clone Repository
git clone https://github.com/PaDev1/Nina_advanced_api_mcp.git cd nina-mcp
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.

Fork the repository
Create your feature branch
Commit your changes
Push to the branch
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

NINA - The core astronomy software
NINA Advanced API - API documentation

Touch'N'Stars - WebApp for Mobile Control of NINA
NINA Plugins - Official NINA plugin repository

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

A protocol server enabling AI agents to control astrophotography equipment through the N.I.N.A. (Nighttime Imaging 'N' Astronomy) software, allowing for natural language command processing of cameras, mounts, focusers, and other astronomy equipment.

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

Related MCP Servers

NSAF MCP Server
ariunbolor
-
security
A
license
-
quality
A Model Context Protocol server that allows AI assistants to interact with the Neuro-Symbolic Autonomy Framework, enabling capabilities like running NSAF evolution with customizable parameters and comparing different agent architectures.
Last updated -
1
Python
MIT License
Video Still Capture MCP
13rac1
-
security
F
license
-
quality
A Model Context Protocol server that enables AI assistants to access and control webcams through OpenCV, allowing for image capture and camera setting manipulation.
Last updated -
11
Python
MCP Server For Local
Dreamboat-Rachel
A
security
A
license
A
quality
A customizable Model Context Protocol server implementation that enables AI models to interact with external tools including weather queries, Google search, and camera control functionality.
Last updated -
1
13
Python
Apache 2.0
MCP OpenVision
mikeysrecipes
A
security
A
license
A
quality
A Model Context Protocol server that enables AI assistants to analyze images using OpenRouter vision models through a simple interface.
Last updated -
1
1
Python
MIT License

View all related MCP servers

Nina Advanced API MCP