AI 代理使用 N.I.N.A 使用天文摄影设置的界面

TonyXiu/Nina_advanced_api_mcp

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

当然，可以帮您翻译。请提供需要翻译的英文技术文档内容。

其他

MCP 服务配置

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

{
  "mcpServers": {
    "nina_advanced_mcp_api": {
      "args": [
        "run",
        "--with",
        "fastmcp,fastapi,uvicorn,pydantic,aiohttp,requests,python-dotenv",
        "fastmcp",
        "run",
        "path/nina_advanced_mcp.py"
      ],
      "command": "uv",
      "env": {
        "IMAGE_SAVE_DIR": "~/Desktop/NINA_Images",
        "LOG_LEVEL": "INFO",
        "NINA_HOST": "NINA_IP",
        "NINA_PORT": "1888"
      }
    }
  }
}

服务介绍

Nina_advanced_api_mcp

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

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

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

🌟 特性

为 AI 代理提供完整的设备控制
- 相机（拍摄、冷却、设置、连接等）
- 赤道仪（移动、停放、跟踪等）
- 调焦器（移动、温度补偿等）
- 滤镜轮（滤镜选择、信息等）
- 圆顶（旋转、快门控制等）
- 旋转器（移动、同步等）
- ...
AI 集成
- 自然语言命令处理
- 上下文帮助系统
- 智能错误响应
- 自动决策制定
支持大多数 NINA 高级 API v2 接口端点

🚀 快速开始

前提条件

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

安装

安装 NINA 高级 API 插件
bash

在 NINA 中安装插件

在 NINA 设置中启用并配置
克隆仓库
bash
git clone https://github.com/PaDev1/Nina_advanced_api_mcp.git
cd nina-mcp
设置环境变量
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 Desktop AI 示例

连接到 nina
读取设置
连接我的相机、赤道仪、滤镜轮和导星设备
读取序列并让我选择要开始的序列

AI 代理命令

plaintext

"对 M31 拍摄 30 秒曝光的照片"
"连接所有设备并将相机冷却至 -10°C"
"开始针对 NGC 7000 的序列"
"获取当前设备状态"

📖 API 文档

核心模块

设备控制

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

成像

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

系统

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

🤝 贡献

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

叉分仓库
创建您的功能分支
提交更改
将更改推送到分支
创建拉取请求

🐛 错误报告

发现错误？请打开一个问题，并附上以下信息：

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

📜 许可证此项目采用MIT许可证 - 详情请参见LICENSE文件。

🙏 致谢

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

🔗 相关项目

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

查看源码项目主页