니나_어드밴스드_API_MCP

NINA(베타)를 사용하여 AI 에이전트가 천체 사진 설정을 사용할 수 있는 인터페이스

고급 API 플러그인 v2(MCP)를 위한 NINA 모델 컨텍스트 프로토콜 서버

고급 API인 NINA(Nighttime Imaging 'N' Astronomy)를 통해 NINA (Nighttime Imaging 'N' Astronomy) 소프트웨어를 제어할 수 있는 강력한 인터페이스입니다. 이 모델 컨텍스트 프로토콜 서버(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 플러그인 설치

   지엑스피1

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

📚 사용법

Claude Destop과 함께하는 기본 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 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

🙏 감사의 말

• NINA - 핵심 천문학 소프트웨어

• NINA 고급 API - API 문서

🔗 관련 프로젝트

• Touch'N'Stars - NINA 모바일 제어를 위한 웹앱

• NINA 플러그인 - 공식 NINA 플러그인 저장소