Nina 高级 API MCP

Nina_advanced_api_mcp

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

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

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

🌟 功能

为 AI 代理提供完整的设备控制
- 摄像机（捕捉、冷却、设置、连接……）
- 支架（旋转、停车、跟踪……）
- 调焦器（运动、温度补偿......）
- 滤光轮（滤光片选择、信息......）
- 圆顶（旋转、快门控制......）
- 旋转器（运动、同步……）
- ...
人工智能集成
- 自然语言命令处理
- 上下文帮助系统
- 智能错误响应
- 自动化决策
**支持大多数 NINA 高级 API v2 api 接口端点

🚀 快速入门

先决条件

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

安装

安装 NINA 高级 API 插件
# Install the plugins in NINA # Enable and configure in NINA settings
克隆存储库
git clone https://github.com/PaDev1/Nina_advanced_api_mcp.git cd nina-mcp
设置环境变量
# 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 文档

核心模块

设备控制

相机操作
安装控制
聚焦者管理
滤光轮控制
圆顶自动化
旋转器功能

影像学

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

系统

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

🤝 贡献

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

分叉存储库
创建你的功能分支
提交你的更改
推送到分支
创建拉取请求

🐛 错误报告

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

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

📜 许可证

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

🙏 致谢

NINA——核心天文学软件
NINA 高级 API - API 文档

🔗 相关项目

Touch'N'Stars - 用于移动控制 NINA 的 WebApp
NINA 插件- 官方 NINA 插件库

Nina Advanced API MCP