N.I.N.A. AI控制台

@PaDev1/Nina_advanced_api_mcp

0 Stars 311 次浏览 PaDev1 更新于 2026-08-23

一个协议服务器，允许AI代理通过N.I.N.A.（夜间成像与天文学）软件控制天文摄影设备，实现对相机、赤道仪、调焦器和其他天文设备的自然语言命令处理。

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

{
  "mcpServers": {
    "nina_advanced_mcp_api": {
      "args": [
        "run",
        "--with",
        "fastmcp,fastapi,uvicorn,pydantic,aiohttp,requests,python-dotenv",
        "fastmcp",
        "run",
        "path/nina_advanced_mcp.py"
      ],
      "command": "uv",
      "env": {
        "IMAGE_SAVE_DIR": "~/Desktop/NINA_Images",
        "LOG_LEVEL": "INFO",
        "NINA_HOST": "NINA_IP",
        "NINA_PORT": "1888"
      }
    }
  }
}

该服务需要配置环境变量：IMAGE_SAVE_DIR、LOG_LEVEL、NINA_HOST、NINA_PORT

服务介绍

Nina_advanced_api_mcp

用于通过N.I.N.A（Beta版）使用您的天文摄影设备的AI代理接口

N.I.N.A 模型上下文协议服务器高级API插件v2 (MCP)

一个强大的接口，用于通过其高级API NINA Advanced API 控制N.I.N.A.（夜间成像与天文学）软件。此模型上下文协议服务器（MCP）使AI代理能够使用工具与NINA交互，提供了一种新的方式来操作您的设置。使用时请自行负责。

🌟 特性

为AI代理提供的完整设备控制
- 相机（拍摄、冷却、设置、连接等）
- 赤道仪（移动、停放、跟踪等）
- 调焦器（移动、温度补偿等）
- 滤镜轮（滤镜选择、信息等）
- 圆顶（旋转、快门控制等）
- 旋转器（移动、同步等）
- ...
AI集成
- 自然语言命令处理
- 上下文帮助系统
- 智能错误响应
- 自动决策制定
支持大多数NINA高级API v2接口端点

🚀 快速开始

前提条件

Python 3.8或更高版本
安装了高级API插件的NINA软件
uv包管理器
支持MCP的AI代理（例如Claude）

安装

安装NINA高级API插件
bash

在NINA中安装插件

在NINA设置中启用并配置
克隆仓库
bash
git clone https://github.com/PaDev1/Nina_advanced_api_mcp.git
cd nina-mcp
设置环境变量
bash

创建.env文件

NINA_HOST=your_nina_host
NINA_PORT=1888
LOG_LEVEL=INFO
IMAGE_SAVE_DIR=~/Desktop/NINA_Images

配置

MCP服务器设置

将以下内容添加到您的AI代理的MCP配置中：
json
{
"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"
}
}
}
}

📚 使用方法

Claude桌面的基本AI示例

连接到nina
读取设置
连接我的相机、赤道仪、滤镜轮和导星
读取序列并让我选择要开始的序列

AI代理命令

plaintext

"对M31进行30秒曝光"
"连接所有设备并将相机冷却至-10°C"
"开始针对NGC 7000的序列"
"获取当前设备状态"

📖 API文档

核心模块

设备控制

相机操作
赤道仪控制
调焦器管理
滤镜轮控制
圆顶自动化
旋转器功能

成像

捕获配置
图像处理
文件管理
统计数据收集

系统

连接处理
状态监控
错误管理
配置

🤝 贡献

欢迎贡献！请先阅读我们的贡献指南。

叉分仓库
创建您的功能分支
提交更改
推送到分支
创建拉取请求

🐛 错误报告

发现错误？请打开一个问题，并附上：

详细描述
复现步骤
期望行为与实际行为
系统信息

📜 许可证

本项目根据MIT许可证发布 - 详情请参阅LICENSE文件。

🙏 致谢- NINA - 核心天文软件

NINA 高级 API - API 文档

🔗 相关项目

Touch N Stars - 用于移动控制 NINA 的 Web 应用
NINA 插件 - 官方 NINA 插件仓库

查看源码项目主页