AWS Documentation

AWS Documentation MCP 서버

AWS Documentation을 위한 모델 컨텍스트 프로토콜(MCP) 서버

이 MCP 서버는 AWS 문서에 접근하고, 콘텐츠를 검색하며, 추천을 받을 수 있는 도구를 제공합니다.

기능

• 문서 읽기: AWS 문서 페이지를 가져와 마크다운 형식으로 변환합니다.
• 문서 검색: 공식 검색 API를 사용하여 AWS 문서를 검색합니다(전역 전용).
• 섹션 읽기: AWS 문서 페이지의 섹션을 가져와 마크다운 형식으로 변환합니다.
• 테이블 검색: 전체 페이지를 읽지 않고 대규모 문서 테이블(예: 서비스 할당량, 요금)의 행을 필터링하고 검색합니다(전역 전용).
• 추천: AWS 문서 페이지에 대한 콘텐츠 추천을 받습니다(전역 전용).
• 사용 가능한 서비스 목록 가져오기: 중국 리전에서 사용 가능한 AWS 서비스 목록을 가져옵니다(중국 전용).

사전 요구 사항

설치 요구 사항

1. Astral 또는 GitHub README에서 uv을(를) 설치합니다.
2. uv python install 3.10을(를) 사용하여 Python 3.10 이상을 설치합니다(또는 최신 버전).

설치

Kiro	Cursor	VS Code

MCP 클라이언트 구성에서 MCP 서버를 구성합니다:

{
  "mcpServers": {
    "awslabs.aws-documentation-mcp-server": {
      "command": "uvx",
      "args": ["awslabs.aws-documentation-mcp-server@latest"],
      "env": {
        "FASTMCP_LOG_LEVEL": "ERROR",
        "AWS_DOCUMENTATION_PARTITION": "aws",
        "MCP_USER_AGENT": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Kiro MCP 구성에 대한 자세한 내용은 Kiro IDE 문서 또는 Kiro CLI 문서를 참조하세요.

전역 구성의 경우 ~/.kiro/settings/mcp.json을(를) 편집합니다. 프로젝트별 구성의 경우 프로젝트 디렉터리에서 .kiro/settings/mcp.json을(를) 편집합니다.

Windows 설치

Windows 사용자의 경우 MCP 서버 구성 형식이 약간 다릅니다:

{
  "mcpServers": {
    "awslabs.aws-documentation-mcp-server": {
      "disabled": false,
      "timeout": 60,
      "type": "stdio",
      "command": "uv",
      "args": [
        "tool",
        "run",
        "--from",
        "awslabs.aws-documentation-mcp-server@latest",
        "awslabs.aws-documentation-mcp-server.exe"
      ],
      "env": {
        "FASTMCP_LOG_LEVEL": "ERROR",
        "AWS_DOCUMENTATION_PARTITION": "aws"
      }
    }
  }
}

참고: AWS_DOCUMENTATION_PARTITION을(를) aws-cn(으)로 설정하면 글로벌 AWS 문서 대신 AWS 중국 문서를 쿼리합니다.

회사 네트워크: 특정 User-Agent 문자열을 차단하는 회사 프록시 또는 방화벽 뒤에 있는 경우, MCP_USER_AGENT을(를) 브라우저의 User-Agent와 일치하는 허용 가능한 문자열로 설정하세요.

또는 docker build -t mcp/aws-documentation . 성공 후 docker를 사용합니다:

{
  "mcpServers": {
    "awslabs.aws-documentation-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "--interactive",
        "--env",
        "FASTMCP_LOG_LEVEL=ERROR",
        "--env",
        "AWS_DOCUMENTATION_PARTITION=aws",
        "mcp/aws-documentation:latest"
      ],
      "env": {},
      "disabled": false,
      "autoApprove": []
    }
  }
}

환경 변수

변수	설명	기본값
FASTMCP_LOG_LEVEL	로깅 수준 (DEBUG, INFO, WARNING, ERROR, CRITICAL)	WARNING
AWS_DOCUMENTATION_PARTITION	AWS 파티션 (aws 또는 aws-cn)	aws
MCP_USER_AGENT	HTTP 요청을 위한 사용자 지정 User-Agent 문자열	Chrome 기반 기본값

회사 네트워크 지원

특정 User-Agent 문자열을 차단하는 프록시 서버 또는 방화벽이 있는 회사 환경의 경우:

{
  "env": {
    "MCP_USER_AGENT": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36"
  }
}

기본 사용법

예시:

• "S3 버킷 이름 규칙에 대한 문서를 찾아보세요. 출처를 인용하세요"
• "https://docs.aws.amazon.com/AmazonS3/latest/userguide/bucketnamingrules.html 페이지에 대한 콘텐츠를 추천해 주세요"

도구

read_documentation

AWS 문서 페이지를 가져와 마크다운 형식으로 변환합니다.

read_documentation(url: str) -> str

search_documentation (전역 전용)

공식 AWS 문서 검색 API를 사용하여 AWS 문서를 검색합니다.

search_documentation(ctx: Context, search_phrase: str, limit: int, product_types: Optional[List[str]], guide_types: Optional[List[str]]) -> SearchResponse

read_sections (전역 전용)

AWS 문서 페이지의 섹션을 가져와 마크다운 형식으로 변환합니다.

read_sections(url: str, section: list[str]) -> list[dict]

search_table (전역 전용)

대규모 문서 테이블(예: 서비스 할당량, 요금 테이블, 지원 모델)에서 특정 행을 검색합니다. 수백 개의 테이블 행이 있는 페이지에서 read_sections보다 효율적입니다 — 전체 테이블 대신 일치하는 행을 구조화된 JSON으로 반환합니다.

search_table(url: str, section_title: Optional[str], query: str, max_rows: int = 20) -> SearchTableResponse

recommend (전역 전용)

AWS 문서 페이지에 대한 콘텐츠 추천을 받습니다.

recommend(url: str) -> list[dict]

get_available_services (중국 전용)

중국 리전에서 사용 가능한 AWS 서비스 목록을 가져옵니다.

get_available_services() -> str

개발

AWS Documentation MCP 서버 개발을 시작하려면 먼저 awslabs/mcp DEVELOPER_GUIDE를 참조하세요. 아래 내용은 모두 AWS Documentation MCP 서버 개발에 특화된 내용입니다.

테스트 실행

단위 테스트: uv run --frozen pytest --cov --cov-branch --cov-report=term-missing 통합 테스트를 포함한 단위 테스트: uv run --frozen pytest --cov --cov-branch --cov-report=term-missing --run-live