# N.I.N.A. AI控制台
## 基本信息
- Slug: `padev1-nina_advanced_api_mcp`
- Source: modelscope
- Publisher: @PaDev1/Nina_advanced_api_mcp
- Categories: app-automation / autonomous-agents / 其他
- Hosted: No
- License: Unknown
- Source URL: https://www.modelscope.cn/mcp/servers/@PaDev1/Nina_advanced_api_mcp
## 简介
一个协议服务器，允许AI代理通过N.I.N.A.（夜间成像与天文学）软件控制天文摄影设备，实现对相机、赤道仪、调焦器和其他天文设备的自然语言命令处理。
## MCP Server 详情

# Nina_advanced_api_mcp
用于通过N.I.N.A（Beta版）使用您的天文摄影设备的AI代理接口
# N.I.N.A 模型上下文协议服务器高级API插件v2 (MCP)

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

<div align="center">

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
[![NINA](https://img.shields.io/badge/NINA-3.0+-green.svg)](https://nighttime-imaging.eu/)

</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文档

### 核心模块

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

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

#### 系统
- 连接处理
- 状态监控
- 错误管理
- 配置

## 🤝 贡献

欢迎贡献！请先阅读我们的[贡献指南](CONTRIBUTING.md)。

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

## 🐛 错误报告

发现错误？请打开一个问题，并附上：
- 详细描述
- 复现步骤
- 期望行为与实际行为
- 系统信息

## 📜 许可证

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

## 🙏 致谢- [NINA](https://nighttime-imaging.eu/) - 核心天文软件
- [NINA 高级 API](https://bump.sh/christian-photo/doc/advanced-api) - API 文档

## 🔗 相关项目

- [Touch N Stars](https://github.com/Touch-N-Stars/Touch-N-Stars) - 用于移动控制 NINA 的 Web 应用
- [NINA 插件](https://nighttime-imaging.eu/plugins/) - 官方 NINA 插件仓库