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

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

app-automationautonomous-agentsother

305 查看 · 2026-07-07 更新

简介

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 插件仓库

服务配置

[{'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'}}}}]

来源

来源：github
链接：https://github.com/PaDev1/Nina_advanced_api_mcp