NINA Advanced API

🚀 天文摄影设备高级API协议服务器插件 v2 (MCP)

本插件借助N.I.N.A（Nighttime Imaging 'N' Astronomy）软件的高级API NINA高级API ，为AI代理打造了一个强大的接口。此模型上下文协议服务器（MCP）让AI代理能够与NINA工具进行交互，开创了一种全新的设备交互方式。请在使用时自行承担风险。

🚀 快速开始

先决条件

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

✨ 主要特性

• 完整的设备控制
  • 摄像机（捕获、冷却、设置、连接等）
  • 转动装置（slew 移动、停车、跟踪等）
  • 对焦器（移动、温度补偿等）
  • 分光轮（滤镜选择、信息等）
  • 天文圆顶（旋转、快门控制等）
  • 旋转器（移动、同步等）
• AI 集成
  • 自然语言命令处理
  • 上下文帮助系统
  • 智能错误响应
  • 自动化决策
• 支持 NINA 高级 API v2 接口的大部分端点

💻 使用示例

基本 AI 示例与 Claude Desktop

• 连接到 nina
• 阅读设置
• 连接所有设备（摄像头、转动装置、分光轮和导星器）
• 阅读序列并选择要启动的序列

AI 代理命令

- "拍摄 M31 的 30 秒曝光"
- "连接所有设备并将摄像头冷却至 -10°C"
- "开始指向 NGC 7000 的目标序列"
- "获取当前设备状态"

📚 详细文档

API 文档

核心模块

设备控制

• 摄像机操作
• 转动装置（slew 移动）
• 对焦器（移动、温度补偿等）
• 分光轮（滤镜选择、信息等）
• 天文圆顶（旋转、快门控制等）
• 旋转器（移动、同步等）

AI 集成

• 自然语言命令处理
• 上下文帮助系统
• 智能错误响应
• 自动化决策

支持 NINA 高级 API v2 接口的大部分端点

🙏 致谢

• NINA - 核心天文软件
• NINA 高级 API - API 文档

🔗 相关项目

• Touch'N'Stars - 移动设备控制 NINA 的 WebApp
• NINA 插件 - 官方 NINA 插件仓库