Skip to main content
Glama
enesjakozh
PaDev1

Nina Advanced API MCP

by PaDev1
OverviewSchemaRelated ServersScoreDiscussions
Local

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

Related MCP server: Video Still Capture MCP

πŸš€ 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

This server cannot be installed

-
security - not tested
F
license - not found
-
quality - not tested

How are these scores calculated?

Resources

New MCP Servers

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/PaDev1/Nina_advanced_api_mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server