NINA Advanced API

🚀 天文撮影機器高度APIプロトコルサーバープラグインv2 (MCP)

Nighttime Imaging 'N' Astronomy（N.I.N.A）ソフトウェアの高度API NINA高度API を通じて、AIエージェントに強力なインターフェースを提供します。このモデルコンテキストプロトコルサーバー（MCP）により、AIエージェントはNINAツールを使って機器との新しいやり取り方法を実現できます。利用は自己責任です。

✨ 主な機能

• 完全な機器制御

  • カメラ（撮影、冷却、設定、接続など）
  • アクチュエーター（移動、停止、追跡など）
  • フォーカサー（移動、温度補正など）
  • フィルターホイール（フィルター選択、情報など）
  • アストロダム（回転、シャッター制御など）
  • ローテーター（移動、同期など）
  • など

• AI統合

  • 自然言語コマンド処理
  • コンテキストヘルプシステム
  • スマートエラー応答
  • 自動化決定

• NINA高度API v2インターフェースの大部分のエンドポイントをサポート

🚀 クイックスタート

前提条件

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

💻 使用例

Claude Desktopでの基本的なAI使用例

• NINAに接続する
• 設定を読み込む
• カメラ、アクチュエーター、フィルターホイール、ガイドカメラを接続する
• シーケンスを読み込み、起動するシーケンスを選択する

AIエージェントコマンド

- "M31を30秒間露出して撮影"
- "すべての機器を接続し、カメラを-10°Cに冷却する"
- "NGC 7000を目標とするシーケンスを開始する"
- "現在の機器状態を取得する"

📚 ドキュメント

コアモジュール

機器制御

• カメラ操作
• アクチュエーター（移動）
• フォーカサー（移動、温度補正など）
• フィルターホイール（フィルター選択、情報など）
• アストロダム（回転、シャッター制御など）
• ローテーター（移動、同期など）

AI統合

• 自然言語コマンド処理
• コンテキストヘルプシステム
• スマートエラー応答
• 自動化決定

NINA高度API v2インターフェースの大部分のエンドポイントをサポート

🙏 謝辞

• NINA - 核心天文ソフトウェア
• NINA高度API - APIドキュメント

🔗 関連プロジェクト

• Touch'N'Stars - モバイルデバイスでNINAを制御するWebアプリ
• NINAプラグイン - 公式NINAプラグインリポジトリ