N.I.N.A 高级API_MCP调用_@PaDev1

TonyXiu/n.i.n.a._advanced_api_mcp

0 Stars 16 次浏览更新于 2026-08-23

作者PaDev1 一个强大的模型上下文协议服务器（MCP），使 AI 代理能够通过其高级 API 控制 N.I.N.A.（夜间成像与天文）软件。该接口允许 AI 代理与通过 NINA 连接的天文摄影设备（相机、支架、调焦器等）进行交互，支持自然语言命令、上下文操作以及天文成像设置中的自动化决策。

其他

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

{
  "mcpServers": {
    "nina_advanced_mcp_api": {
      "args": [
        "nina_advanced_mcp",
        "run",
        "nina_advanced_mcp/__init__.py"
      ],
      "command": "uvx",
      "env": {
        "IMAGE_SAVE_DIR": "~/Desktop/NINA_Images",
        "LOG_LEVEL": "INFO",
        "NINA_HOST": "HOST",
        "NINA_PORT": "1888"
      }
    }
  }
}

该服务需要配置环境变量：IMAGE_SAVE_DIR、NINA_HOST、NINA_PORT

服务介绍

Nina_advanced_api_mcp

为AI代理使用N.I.N.A（测试版）控制您的天文摄影设备的接口

📝 服务介绍

一个强大的模型上下文协议服务器 (MCP)，使AI代理能够通过其高级API控制N.I.N.A.（夜间成像和天文学）软件。此接口允许AI代理与通过NINA连接的天文摄影设备（相机、赤道仪、调焦器等）进行交互，支持自然语言命令、上下文操作以及针对天文成像设置的自动化决策。

🌟 主要功能

全面的设备控制
通过NINA的高级API支持相机、赤道仪、调焦器、滤镜轮、穹顶、旋转器和其他天文设备。
AI代理集成
自然语言命令处理、上下文帮助、智能错误处理和自动化决策能力。
完整的NINA高级API v2支持
实现了NINA高级API的大多数端点，以实现与核心软件的无缝交互。

📋 前提条件

Python 3.8或更高版本
NINA软件（v3.0+），已安装并启用高级API插件
uv包管理器（用于依赖项管理）
支持MCP的AI代理（例如，Claude）

🚀 安装与设置

1. 安装NINA高级API插件

在NINA软件中安装高级API插件。
通过NINA的设置菜单启用并配置该插件。

2. 克隆仓库

bash
git clone https://github.com/PaDev1/Nina_advanced_api_mcp.git
cd Nina_advanced_api_mcp

3. 配置环境变量

创建一个.env文件，并添加以下变量：
env
NINA_HOST=your_nina_host # 运行NINA的机器的IP地址
NINA_PORT=1888 # NINA高级API的默认端口
LOG_LEVEL=INFO # 日志级别（DEBUG, INFO, WARNING, ERROR）
IMAGE_SAVE_DIR=~/Desktop/NINA_Images # 保存图像的本地目录

⚙️ 服务器配置（MCP服务器设置）

将以下配置添加到您的AI代理的MCP设置中，以便与此服务连接：

json
{
"mcpServers": {
"nina_advanced_mcp_api": {
"command": "uvx",
"args": [
"nina-advanced-api-mcp@latest",
"run",
"nina_advanced_mcp.py"
],
"env": {
"NINA_HOST": "NINA_IP",
"NINA_PORT": "1888",
"LOG_LEVEL": "INFO",
"IMAGE_SAVE_DIR": "~/Desktop/NINA_Images"
}
}
}
}

ModelScope部署注意事项：此配置针对ModelScope的自动部署检测进行了优化。它使用uvx作为命令（符合ModelScope的要求），并通过@latest指定包以确保使用最新版本。

🔍 使用示例

AI代理的基本命令

"对M31进行30秒曝光"
"连接所有设备并将相机冷却至-10°C"
"开始NGC 7000的成像序列"
"报告当前设备状态"

📜 许可证

MIT许可证 - 详情请参阅LICENSE。

🙏 致谢

NINA - 核心天文成像软件
NINA高级API - API文档和插件
ModelScope - 用于启用MCP服务共享和分发

🔗 相关项目

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

查看源码项目主页