AWS Documentation

Máy chủ MCP Tài liệu AWS

Máy chủ Giao thức Ngữ cảnh Mô hình (MCP) dành cho Tài liệu AWS

Máy chủ MCP này cung cấp các công cụ để truy cập tài liệu AWS, tìm kiếm nội dung và nhận đề xuất.

Tính năng

• Đọc Tài liệu: Tải và chuyển đổi các trang tài liệu AWS sang định dạng markdown
• Tìm kiếm Tài liệu: Tìm kiếm tài liệu AWS bằng API tìm kiếm chính thức (chỉ toàn cầu)
• Đọc Mục: Tải các mục của trang tài liệu AWS và chuyển đổi sang định dạng markdown.
• Đề xuất: Nhận đề xuất nội dung cho các trang tài liệu AWS (chỉ toàn cầu)
• Lấy Danh sách Dịch vụ Khả dụng: Lấy danh sách các dịch vụ AWS khả dụng tại các khu vực Trung Quốc (chỉ Trung Quốc)

Điều kiện tiên quyết

Yêu cầu Cài đặt

1. Cài đặt uv từ Astral hoặc GitHub README
2. Cài đặt Python 3.10 trở lên bằng uv python install 3.10 (hoặc phiên bản mới hơn)

Cài đặt

Kiro	Cursor	VS Code

Cấu hình máy chủ MCP trong cấu hình máy khách MCP của bạn:

{
  "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": []
    }
  }
}

Đối với cấu hình Kiro MCP, xem tài liệu Kiro IDE hoặc tài liệu Kiro CLI để biết chi tiết.

Đối với cấu hình toàn cầu, chỉnh sửa ~/.kiro/settings/mcp.json. Đối với cấu hình riêng cho dự án, chỉnh sửa .kiro/settings/mcp.json trong thư mục dự án của bạn.

Cài đặt trên Windows

Đối với người dùng Windows, định dạng cấu hình máy chủ MCP hơi khác một chút:

{
  "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"
      }
    }
  }
}

Lưu ý: Đặt AWS_DOCUMENTATION_PARTITION thành aws-cn để truy vấn tài liệu AWS Trung Quốc thay vì tài liệu AWS toàn cầu.

Mạng Doanh nghiệp: Nếu bạn đứng sau proxy hoặc tường lửa doanh nghiệp chặn một số chuỗi User-Agent nhất định, hãy đặt MCP_USER_AGENT để khớp với User-Agent của trình duyệt của bạn thành một chuỗi được phép.

hoặc docker sau khi docker build -t mcp/aws-documentation . thành công:

{
  "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": []
    }
  }
}

Biến Môi trường

Biến	Mô tả	Mặc định
FASTMCP_LOG_LEVEL	Mức ghi nhật ký (DEBUG, INFO, WARNING, ERROR, CRITICAL)	WARNING
AWS_DOCUMENTATION_PARTITION	Phân vùng AWS (aws hoặc aws-cn)	aws
MCP_USER_AGENT	Chuỗi User-Agent tùy chỉnh cho các yêu cầu HTTP	Mặc định dựa trên Chrome

Hỗ trợ Mạng Doanh nghiệp

Đối với môi trường doanh nghiệp có máy chủ proxy hoặc tường lửa chặn một số chuỗi User-Agent nhất định:

{
  "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"
  }
}

Cách sử dụng Cơ bản

Ví dụ:

• "tra cứu tài liệu về quy tắc đặt tên bucket S3. trích dẫn nguồn của bạn"
• "đề xuất nội dung cho trang https://docs.aws.amazon.com/AmazonS3/latest/userguide/bucketnamingrules.html"

Công cụ

read_documentation

Tải một trang tài liệu AWS và chuyển đổi sang định dạng markdown.

read_documentation(url: str) -> str

search_documentation (chỉ toàn cầu)

Tìm kiếm tài liệu AWS bằng API Tìm kiếm Tài liệu AWS chính thức.

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

read_sections (chỉ toàn cầu)

Tải các mục của trang tài liệu AWS và chuyển đổi sang định dạng markdown.

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

recommend (chỉ toàn cầu)

Nhận đề xuất nội dung cho một trang tài liệu AWS.

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

get_available_services (chỉ Trung Quốc)

Lấy danh sách các dịch vụ AWS khả dụng tại các khu vực Trung Quốc.

get_available_services() -> str

Phát triển

Để bắt đầu phát triển trên máy chủ MCP Tài liệu AWS, vui lòng tham khảo awslabs/mcp DEVELOPER_GUIDE trước. Mọi thứ bên dưới đây dành riêng cho phát triển Máy chủ MCP Tài liệu AWS.

Chạy kiểm thử

Kiểm thử đơn vị: uv run --frozen pytest --cov --cov-branch --cov-report=term-missing Kiểm thử đơn vị với kiểm thử tích hợp: uv run --frozen pytest --cov --cov-branch --cov-report=term-missing --run-live