github/mcp-deploy-manage-agents

mcp-deploy-manage-agents은(는) 무엇을 하나요?

MCP 에이전트 배포 및 관리를 위한 스킬입니다.

이 스킬은 MCP(Model Context Protocol) 기반 에이전트를 GitHub을 사용하여 배포하고 관리하는 방법을 안내합니다. 주요 기능은 다음과 같습니다:

• CI/CD 파이프라인 설정: GitHub Actions를 사용하여 자동화된 배포 파이프라인 구축
• 환경 관리: 개발, 스테이징, 프로덕션 환경별 설정 관리
• 버전 관리: Git 태그와 릴리스를 통한 에이전트 버전 관리
• 모니터링 및 로깅: 배포된 에이전트의 상태를 모니터링하고 로그 수집
• 롤백 전략: 문제 발생 시 빠른 롤백을 위한 절차 수립
• 보안 설정: API 키, 환경 변수 등 민감 정보를 안전하게 관리

사전 요구 사항

• GitHub 계정 및 저장소
• MCP 에이전트 코드 (Node.js, Python 등)
• 클라우드 서비스 계정 (예: AWS, GCP, Azure) 또는 자체 호스팅 서버
• Docker (선택 사항, 컨테이너화된 배포를 위해)

사용 방법

1. 저장소를 클론합니다:

   git clone https://github.com/your-username/your-agent-repo.git
   cd your-agent-repo
   

2. 배포 설정 파일을 구성합니다:

   # .github/workflows/deploy.yml
   name: Deploy MCP Agent
   
   on:
     push:
       branches: [main]
   
   jobs:
     deploy:
       runs-on: ubuntu-latest
       steps:
         - uses: actions/checkout@v3
         - name: Deploy to Cloud
           run: |
             echo "Deploying MCP agent..."
             # 배포 명령어 추가
   

3. 환경 변수를 설정합니다:

   # .env.example
   MCP_SERVER_PORT=3000
   DATABASE_URL=postgresql://user:password@localhost:5432/mcp_agent
   API_KEY=your-api-key
   

4. 배포 스크립트를 실행합니다:

   npm run deploy
   # 또는
   python deploy.py
   

설정 세부 사항

GitHub Actions 워크플로우

워크플로우 파일은 .github/workflows/ 디렉토리에 위치합니다. 주요 단계:

1. 코드 체크아웃: 저장소에서 최신 코드 가져오기
2. 의존성 설치: npm install 또는 pip install -r requirements.txt
3. 테스트 실행: 단위 테스트 및 통합 테스트 수행
4. 빌드: Docker 이미지 빌드 또는 애플리케이션 번들링
5. 배포: 대상 환경에 배포 (SSH, Kubernetes, Serverless 등)
6. 상태 확인: 배포 후 헬스 체크 엔드포인트 확인

환경 변수 관리

GitHub Secrets를 사용하여 민감한 환경 변수를 관리합니다:

gh secret set DEPLOY_KEY < your-private-key.pem
gh secret set DATABASE_URL

문제 해결

• 배포 실패: 워크플로우 로그를 확인하고, 필요한 권한이 있는지 검토합니다.
• 에이전트 연결 오류: 환경 변수와 설정 파일을 확인합니다.
• 롤백 필요 시: git revert 또는 이전 릴리스 태그로 되돌립니다.

참고 자료

• MCP 공식 문서
• GitHub Actions 문서
• Docker 배포 가이드

---

이 스킬은 mcp-deploy-manage-agents.prompt.md에서 변환되었습니다.