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交互，提供了一种新的方式来操作您的设置。使用时请自行负责。

<div align="center">

</div>

🌟 特性

• 为AI代理提供的完整设备控制

  • 相机（拍摄、冷却、设置、连接等）
  • 赤道仪（移动、停放、跟踪等）
  • 调焦器（移动、温度补偿等）
  • 滤镜轮（滤镜选择、信息等）
  • 圆顶（旋转、快门控制等）
  • 旋转器（移动、同步等）
  • ...

• AI集成

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

• 支持大多数NINA高级API v2接口端点

🚀 快速开始

前提条件

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

安装

1. 安装NINA高级API插件 bash

   在NINA中安装插件

   在NINA设置中启用并配置

2. 克隆仓库 bash git clone https://github.com/PaDev1/Nina_advanced_api_mcp.git cd nina-mcp

3. 设置环境变量 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文档

核心模块

设备控制

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

成像

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

系统

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

🤝 贡献

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

1. 叉分仓库
2. 创建您的功能分支
3. 提交更改
4. 推送到分支
5. 创建拉取请求

🐛 错误报告

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

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

📜 许可证

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

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

• NINA 高级 API - API 文档

🔗 相关项目

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