Nina_advanced_api_mcp

人工智能代理使用 NINA（测试版）天文摄影设置的界面

用于高级 API 插件 v2 (MCP) 的 NINA 模型上下文协议服务器

一个强大的接口，用于通过其高级 API （NINA Advanced API ）控制 NINA（夜间成像天文学）软件。此模型上下文协议服务器 (MCP) 允许 AI 代理使用工具与 NINA 进行交互，从而提供与您的设置进行交互的新方式。使用过程中，您需自行承担相关责任。

🌟 功能

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

  • 摄像机（捕捉、冷却、设置、连接……）

  • 支架（旋转、停车、跟踪……）

  • 调焦器（运动、温度补偿......）

  • 滤光轮（滤光片选择、信息......）

  • 圆顶（旋转、快门控制......）

  • 旋转器（运动、同步……）

  • ...

• 人工智能集成

  • 自然语言命令处理

  • 上下文帮助系统

  • 智能错误响应

  • 自动化决策

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

Related MCP server: Video Still Capture MCP

🚀 快速入门

先决条件

• Python 3.8 或更高版本

• 带有高级 API 插件的 NINA 软件

• uv包管理器

• 具有 MCP 支持的 AI 代理（例如 Claude）

安装

1. 安装 NINA 高级 API 插件

   # Install the plugins in NINA
   # Enable and configure in NINA settings

2. 克隆存储库

   git clone https://github.com/PaDev1/Nina_advanced_api_mcp.git
   cd nina-mcp

3. 设置环境变量

   # Create .env file
   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"
      }
    }
  }
}

📚 使用方法

Claude Destop 的基本 AI 示例

• 连接到 nina

• 阅读设置

• 连接我的相机、支架、滤光轮和导星镜

• 阅读序列并让我选择要开始的序列

AI代理命令

- "Take a 30-second exposure of M31"
- "Connect all equipment and start cooling the camera to -10°C"
- "Start a sequence targeting NGC 7000"
- "Get the current equipment status"

📖 API 文档

核心模块

设备控制

• 相机操作

• 安装控制

• 聚焦者管理

• 滤光轮控制

• 圆顶自动化

• 旋转器功能

影像学

• 捕获配置

• 图像处理

• 文件管理

• 统计收集

系统

• 连接处理

• 状态监控

• 错误管理

• 配置

🤝 贡献

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

1. 分叉存储库

2. 创建你的功能分支

3. 提交你的更改

4. 推送到分支

5. 创建拉取请求

🐛 错误报告

发现 Bug 了吗？请使用以下方式提交问题：

• 详细描述

• 复现步骤

• 预期行为与实际行为

• 系统信息

📜 许可证

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅LICENSE文件。

🙏 致谢

• NINA——核心天文学软件

• NINA 高级 API - API 文档

🔗 相关项目

• Touch'N'Stars - 用于移动控制 NINA 的 WebApp

• NINA 插件- 官方 NINA 插件库