ニーナ_advanced_api_mcp

AI エージェントが NINA を使用して天体写真撮影セットアップを使用するためのインターフェース (ベータ版)

NINA モデル コンテキスト プロトコル サーバー (Advanced API プラグイン v2 (MCP))

NINA（Nighttime Imaging 'N' Astronomy）ソフトウェアをAdvanced API （NINA Advanced API）を介して制御するための強力なインターフェースです。このモデルコンテキストプロトコルサーバー（MCP）により、AIエージェントはツールを使用してNINAと対話することができ、セットアップと対話する新しい方法を提供します。ご使用は自己責任でお願いします。

🌟 特徴

• AIエージェントのための完全な機器制御

  • カメラ（撮影、冷却、設定、接続など）

  • マウント（旋回、駐車、追跡など）

  • フォーカサー（移動、温度補正など）

  • フィルター ホイール (フィルターの選択、情報など)

  • ドーム（回転、シャッター制御など）

  • ローテーター（動き、同期など）

  • ...

• AI統合

  • 自然言語コマンド処理

  • コンテキストヘルプシステム

  • インテリジェントなエラー応答

  • 自動化された意思決定

• **NINA アドバンスド API v2 API インターフェースエンドポイントのほとんどがサポートされています

Related MCP server: mcp-server-ascom

🚀 クイックスタート

前提条件

• Python 3.8以上

• 高度なAPIプラグインを備えたNINAソフトウェア

• uvパッケージマネージャー

• MCP サポートを備えた AI エージェント (例: Claude)

インストール

1. NINA Advanced 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"
      }
    }
  }
}

📚 使用方法

クロード・デストップによる基本的なAIの例

• ニーナに接続

• セットアップを読む

• カメラ、マウント、フィルターホイール、ガイダーを接続する

• シーケンスを読み取り、開始するシーケンスを選択できるようにします

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. プルリクエストを作成する

🐛 バグレポート

バグを発見しましたか？以下の方法で問題を報告してください：

• 詳細な説明

• 再現手順

• 期待される行動と実際の行動

• システム情報

📜 ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。

🙏 謝辞

• NINA - 天文学のコアソフトウェア

• NINA アドバンス API - API ドキュメント

🔗 関連プロジェクト

• Touch'N'Stars - NINAのモバイルコントロール用Webアプリ

• NINAプラグイン- 公式NINAプラグインリポジトリ