ニーナ_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 インターフェースエンドポイントのほとんどがサポートされています
🚀 クイックスタート
前提条件
- Python 3.8以上
- 高度なAPIプラグインを備えたNINAソフトウェア
uvパッケージマネージャー- MCP サポートを備えた AI エージェント (例: Claude)
インストール
- NINA Advanced 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"
}
}
}
}
📚 使用方法
クロード・デストップによる基本的な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ドキュメント
コアモジュール
機器制御
- カメラ操作
- マウントコントロール
- フォーカサー管理
- フィルターホイールコントロール
- ドーム自動化
- ローテーター関数
画像診断
システム
🤝 貢献する
貢献を歓迎します！まずは貢献ガイドラインをお読みください。
- リポジトリをフォークする
- 機能ブランチを作成する
- 変更をコミットする
- ブランチにプッシュする
- プルリクエストを作成する
🐛 バグレポート
バグを発見しましたか？以下の方法で問題を報告してください：
- 詳細な説明
- 再現手順
- 期待される行動と実際の行動
- システム情報
📜 ライセンス
このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。
🙏 謝辞
🔗 関連プロジェクト