NINA Advanced API

🚀 天文攝影設備高級API協議服務器插件 v2 (MCP)

本插件藉助N.I.N.A（Nighttime Imaging 'N' Astronomy）軟件的高級API NINA高級API ，為AI代理打造了一個強大的接口。此模型上下文協議服務器（MCP）讓AI代理能夠藉助NINA工具進行交互，開創了一種全新的設備交互方式。請使用者自行承擔使用風險。

✨ 主要特性

• 完整的設備控制

  • 攝像機：可進行捕獲、冷卻、設置、連接等操作。
  • 轉動裝置：支持slew移動、停車、跟蹤等功能。
  • 對焦器：能實現移動、溫度補償等操作。
  • 分光輪：可進行濾鏡選擇、獲取信息等操作。
  • 天文圓頂：支持旋轉、快門控制等操作。
  • 旋轉器：可進行移動、同步等操作。
  • 還有更多功能待你探索。

• AI集成

  • 自然語言命令處理：能夠處理自然語言形式的命令。
  • 上下文幫助系統：提供上下文相關的幫助信息。
  • 智能錯誤響應：對錯誤情況進行智能響應。
  • 自動化決策：實現自動化的決策功能。

• 支持NINA高級API v2接口的大部分端點

🚀 快速開始

先決條件

• Python 3.8或更高版本。
• 帶有高級API插件的NINA軟件。
• uv 包管理器。
• 具備MCP支持的AI代理（例如Claude）。

📦 安裝指南

1. 安裝NINA高級API插件

   # 在NINA中安裝插件
   # 在NINA設置中啟用並配置
   

2. 克隆倉庫

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

3. 設置環境變量

   # 創建.env文件
   NINA_HOST=your_nina_host
   NINA_PORT=1888
   LOG_LEVEL=INFO
   IMAGE_SAVE_DIR=~/Desktop/NINA_Images
   

配置

MCP服務器設置

將以下內容添加到AI代理的MCP配置中：

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

💻 使用示例

基本AI示例與Claude Desktop

• 連接到nina。
• 閱讀設置。
• 連接我的攝像頭、轉動裝置、分光輪和導星器。
• 閱讀序列並讓我選擇要啟動的序列。

AI代理命令

- "拍攝M31的30秒曝光"
- "連接所有設備並將攝像頭冷卻至-10°C"
- "開始指向NGC 7000的目標序列"
- "獲取當前設備狀態"

📚 詳細文檔

API文檔

核心模塊

設備控制

• 攝像機操作：可對攝像機進行各種操作。
• 轉動裝置（slew移動）：實現轉動裝置的slew移動功能。
• 對焦器（移動、溫度補償 ... ）：對焦器的移動和溫度補償等操作。
• 分光輪（濾鏡選擇、信息 ...）：分光輪的濾鏡選擇和信息獲取等操作。
• 天文圓頂（旋轉、快門控制 ...）：天文圓頂的旋轉和快門控制等操作。
• 旋轉器（移動、同步 ...）：旋轉器的移動和同步等操作。

AI集成

• 自然語言命令處理：處理自然語言命令。
• 上下文幫助系統：提供上下文幫助。
• 智能錯誤響應：智能處理錯誤情況。
• 自動化決策：實現自動化決策。

支持NINA高級API v2接口的大部分端點

🙏 致謝

• NINA - 核心天文軟件。
• NINA高級API - API文檔。

🔗 相關項目

• Touch'N'Stars - 移動設備控制NINA的WebApp。
• NINA插件 - 官方NINA插件倉庫。