AWS Documentation MCP (awslabs) — Claude Code MCP 서버

AWS 공식(awslabs) 문서 MCP 서버. AWS 공식 문서를 검색/조회하고 마크다운으로 변환, 관련 페이지를 추천한다.

AWS Documentation MCP는 Amazon Web Services가 awslabs 조직에서 공개·유지하는 공식 MCP(Model Context Protocol) 서버로, Claude Code 같은 MCP 클라이언트가 방대한 AWS 공식 문서를 직접 검색하고 조회할 수 있게 해준다. 핵심 동작은 세 가지다. 첫째, 문서 검색 — 키워드나 자연어 질의로 관련 AWS 문서 페이지를 찾는다. 둘째, 페이지 조회·변환 — 특정 문서 페이지를 가져와 LLM이 다루기 좋은 마크다운 형태로 변환해 제공한다. 셋째, 관련 페이지 추천 — 보고 있는 문서와 연관된 문서를 함께 제안해 맥락을 넓혀준다.

이 서버가 푸는 문제는 명확하다. AWS는 서비스 수가 많고 문서가 자주 갱신되기 때문에, 모델의 학습 시점 지식만으로 답하면 옛 정보나 부정확한 API/CLI 사용법을 제시할 위험이 크다. AWS Documentation MCP를 붙이면 모델이 답변 시점에 공식 문서를 직접 조회해 근거 있는 답을 만들 수 있어, IAM 정책 예시, S3·Lambda·EC2 등 서비스 설정, CLI/SDK 사용법, 한도·요금 페이지 확인 같은 작업의 정확도가 올라간다. 마크다운 변환 덕분에 결과를 코드나 문서에 바로 인용·정리하기도 쉽다.

누가 쓰면 좋은가. AWS 위에서 인프라를 짜거나 운영하는 개발자·DevOps·SRE, IaC(CloudFormation/CDK/Terraform)나 서버리스 구성을 작성하면서 공식 레퍼런스를 빈번히 확인하는 사람, AWS 학습 중 정확한 1차 출처를 원하는 사용자에게 적합하다. Python(uvx) 기반으로 배포되며 별도 API 키 없이 공개 문서를 다루는 구성이 일반적이지만, 옵션·동작 세부는 변동될 수 있으니 공식 저장소(awslabs/mcp) 문서를 확인하는 것을 권장한다. AWS 계정 자원을 직접 조작하는 도구가 아니라 어디까지나 "문서" 조회용임을 유념하면 된다.

언제 쓰나

AWS 서비스 설정·API·CLI/SDK 사용법을 최신 공식 문서 기준으로 확인하며 답을 만들고 싶을 때 적합하다. 모델의 옛 지식으로 인한 부정확을 줄이고, IAM 정책·서버리스·IaC 작성 시 1차 출처를 인용하고 싶을 때 유용하다. 검색→해당 페이지 마크다운 조회→관련 페이지 확장 흐름으로 AWS 문서 탐색을 자동화하려는 개발자·DevOps에게 권한다.

설치

claude mcp add aws-docs -- uvx awslabs.aws-documentation-mcp-server@latest

Python 패키지를 uvx로 즉시 실행하는 방식이므로 사전에 Python 환경과 uv/uvx가 설치돼 있어야 한다(uvx가 없으면 명령이 실패). @latest 태그는 매 실행 시 최신 버전을 받으므로 첫 호출 시 네트워크 다운로드가 발생할 수 있고, 재현성이 중요하면 버전 고정을 고려한다. 추가/등록 후 MCP 클라이언트(Claude Code)에서 서버가 정상 연결됐는지 확인하고, 도구 이름·옵션·필요 런타임 등 세부는 변동될 수 있으니 awslabs/mcp 공식 저장소 문서를 확인하는 것을 권장한다.

보안 주의

이 서버는 공개된 AWS 공식 문서를 검색·조회하는 용도로, 위 구성상 별도 비밀키나 AWS 자격증명을 요구하지 않는다(env 비어 있음). 다만 외부에서 가져온 문서 본문이 모델 컨텍스트로 들어오므로, 문서나 검색 결과에 포함된 텍스트가 프롬프트 인젝션 통로가 될 가능성을 인지하고 그 내용을 무비판적으로 실행 지시로 받아들이지 않도록 주의한다. 실행 시 외부 패키지(uvx로 내려받는 코드)를 신뢰하는 것이므로 출처(awslabs)와 무결성을 확인한다. 이 도구 자체는 AWS 계정 자원을 생성·삭제·과금하지 않지만, 문서에서 본 명령을 실제 계정에 적용할 때는 권한·요금·삭제 영향을 별도로 검토해야 한다.

자주 묻는 질문

AWS 계정에 직접 접근하거나 리소스를 변경하나요?

아니요. 이 MCP는 AWS 공식 문서를 검색·조회·마크다운 변환하고 관련 페이지를 추천하는 문서 도구입니다. 계정 자원 생성·삭제·과금 같은 조작은 하지 않으며, 그 구성상 AWS 자격증명도 요구하지 않습니다. 다만 문서에서 얻은 명령을 실제 계정에 적용할 때는 권한·요금·영향을 별도로 확인하세요.

실행에 무엇이 필요하고 API 키가 드나요?

uvx로 Python 패키지를 실행하는 방식이라 Python과 uv/uvx 환경이 필요합니다. 위 구성에서는 별도 API 키나 비밀키 설정이 없습니다. 런타임·옵션 세부는 바뀔 수 있으니 awslabs/mcp 공식 저장소 문서를 확인하는 것을 권장합니다.

왜 모델에 그냥 묻지 않고 이 MCP를 쓰나요?

AWS는 서비스가 많고 문서가 자주 갱신되어 모델의 학습 시점 지식만으로는 옛 정보나 부정확한 사용법을 줄 수 있습니다. 이 MCP는 답변 시점에 공식 문서를 직접 조회해 근거 있는 답과 인용을 만들 수 있게 해 정확도를 높여줍니다.