니나_어드밴스드_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 인터페이스 엔드포인트가 지원됩니다.
🚀 빠른 시작
필수 조건
- Python 3.8 이상
- 고급 API 플러그인이 포함된 NINA 소프트웨어
uv 패키지 관리자- MCP 지원을 갖춘 AI 에이전트(예: Claude)
설치
- NINA Advanced API 플러그인 설치지엑스피1
- 복제 저장소
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"
}
}
}
}
📚 사용법
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 문서
핵심 모듈
장비 제어
- 카메라 작동
- 마운트 제어
- 포커서 관리
- 필터 휠 제어
- 돔 자동화
- 회전자 기능
이미징
체계
🤝 기여하기
참여를 환영합니다! 먼저 참여 지침을 읽어주세요.
- 저장소를 포크하세요
- 기능 브랜치를 생성하세요
- 변경 사항을 커밋하세요
- 지점으로 밀어 넣기
- 풀 리퀘스트 만들기
🐛 버그 리포트
버그를 발견하셨나요? 다음 내용으로 문제를 제기해 주세요.
- 자세한 설명
- 재현 단계
- 예상된 동작과 실제 동작
- 시스템 정보
📜 라이센스
이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.
🙏 감사의 말
🔗 관련 프로젝트