Nina_advanced_api_mcp

通过N.I.N.A（Beta）接口让AI代理使用您的天体摄影设备。

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

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

<div align="center">

</div>

🌟 特性

• 完整的设备控制供AI代理使用

  • 相机（捕获、冷却、设置、连接……）
  • 赤道仪（移动、停车、跟踪……）
  • 聚焦器（运动、温度补偿……）
  • 滤镜轮（滤镜选择、信息……）
  • 圆顶（旋转、快门控制……）
  • 转动器（运动、同步……）
  • …

• AI集成

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

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

🚀 快速开始

先决条件

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

📚 使用方法

基本AI示例与Claude桌面

• 连接到nina
• 读取设置
• 连接我的相机、赤道仪、滤镜轮和引导器
• 读取序列并让我选择要启动的序列

AI代理命令

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