모듈형 역량 플러그인(MCP)을 사용한 Amazon Q 설정 가이드 (Arch Linux 기반)

카테고리

프로그래밍/소프트웨어 개발

서브카테고리

DevOps

대상자

• 대상: DevOps 및 클라우드 엔지니어, Arch Linux 사용자
• 난이도: 중급 (Python, AWS CLI, CLI 명령어 이해 필요)

핵심 요약

• MCP(Modular Capability Plugins)는 AI 어시스턴트(예: Amazon Q)에 특정 기능을 추가하는 확장 프로그램으로, awslabs.aws-diagram-mcp-server, awslabs.terraform-mcp-server 등의 플러그인 사용이 핵심
• 설치 전 요구사항: Python 3.10, python-uv, AWS CLI, GraphViz
• 설치 명령어 예시: curl --proto '=https' --tlsv1.2 -sSf " -o "q.zip" 후 ./q/install.sh 실행

섹션별 세부 요약

1. MCP란 무엇인가?

• MCP는 AI 어시스턴트의 특정 기능을 강화하는 "스페셜라이즈드 도구 벨트"
• 예: AWS 아키텍처 다이어그램 생성, Terraform 보안 가이드 제공

2. 사용자 경험 및 도전 과제

• 사용자 경험: Amazon Q를 사용한 DevOps 작업 효율성 향상
• 도전 과제:
• AWS 아키텍처 다이어그램 수작업 작성 시간 소요
• AWS 문서 검색 효율성 저하
• Terraform 보안 가이드 준수 어려움

3. MCP 솔루션 구성

• 설치된 MCP:
• awslabs.aws-diagram-mcp-server: AWS 아키텍처 다이어그램 자동 생성
• awslabs.aws-documentation-mcp-server: AWS 문서 검색 및 마크다운 변환
• awslabs.terraform-mcp-server: Terraform 보안 가이드, Checkov 통합

4. Arch Linux 설치 단계

• 필수 사전 설치:
• Python 3.10, python-uv, AWS CLI, GraphViz
• 설치 명령어:
• curl --proto '=https' --tlsv1.2 -sSf " -o "q.zip"
• unzip q.zip 후 ./q/install.sh 실행
• MCP 구성 파일 생성: ~/.aws/amazonq/mcp.json에 플러그인 설정

5. MCP 사용 및 테스트

• 사용 방법: Amazon Q에서 /tools 입력 후 사용 가능한 도구 확인
• 테스트 예시:
• 프롬프트: generate an aws architecture diagram for sample s3 bucket with cloudfront for hosting static website
• 결과: GraphViz를 통해 생성된 아키텍처 다이어그램

결론

• 실무 팁: Python 버전, uv 패키지, GraphViz 설치 확인 후 테스트 수행
• 핵심 구현: awslabs.terraform-mcp-server를 통해 Terraform 보안 프로세스 자동화 가능
• 참고: 필요 없는 MCP는 mcp.json 파일에서 제거하여 성능 최적화