AWS Documentation

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

Máy chủ Giao thức Ngữ cảnh Mô hình (MCP) 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ìm nạp 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 Phần: Tìm nạp các phần của trang tài liệu AWS và chuyển đổi sang định dạng markdown.
• Bảng Tìm kiếm: Lọc và tìm kiếm các hàng trong các bảng tài liệu lớn (ví dụ: hạn ngạch dịch vụ, giá cả) mà không cần đọc toàn bộ trang (chỉ toàn cầu)
• Đề 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 hoặc mới hơn bằng uv python install 3.10 (hoặc phiên bản gần đây 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, hãy 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, hãy chỉnh sửa ~/.kiro/settings/mcp.json. Đối với cấu hình cụ thể của dự án, hãy chỉnh sửa .kiro/settings/mcp.json trong thư mục dự án của bạn.

Cài đặt 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 của công ty 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ìm nạp 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ìm nạp các phần 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]

search_table (chỉ toàn cầu)

Tìm kiếm các hàng cụ thể trong các bảng tài liệu lớn (ví dụ: hạn ngạch dịch vụ, bảng giá, mô hình được hỗ trợ). Hiệu quả hơn read_sections đối với các trang có hàng trăm hàng trong bảng — trả về các hàng phù hợp dưới dạng JSON có cấu trúc thay vì toàn bộ bảng.

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

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 HƯỚNG DẪN PHÁT TRIỂN awslabs/mcp 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