AWS Documentation

AWS Documentation MCP Server

Сервер Model Context Protocol (MCP) для документации AWS

Этот MCP-сервер предоставляет инструменты для доступа к документации AWS, поиска контента и получения рекомендаций.

Возможности

• Чтение документации: Получение и преобразование страниц документации AWS в формат markdown
• Поиск по документации: Поиск по документации AWS с использованием официального API поиска (только глобальный)
• Чтение разделов: Получение разделов страницы документации AWS и преобразование их в формат markdown.
• Поиск по таблице: Фильтрация и поиск строк в больших таблицах документации (например, квоты сервисов, цены) без чтения всей страницы (только глобальный)
• Рекомендации: Получение рекомендаций по контенту для страниц документации AWS (только глобальный)
• Получение списка доступных сервисов: Получение списка доступных сервисов AWS в регионах Китая (только Китай)

Предварительные требования

Требования к установке

1. Установите uv с Astral или из GitHub README
2. Установите Python 3.10 или новее с помощью uv python install 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 China вместо глобальной документации AWS.

Корпоративные сети: Если вы находитесь за корпоративным прокси или брандмауэром, который блокирует определенные строки User-Agent, установите MCP_USER_AGENT в соответствии с User-Agent вашего браузера на допустимую строку.

или docker после успешного docker build -t mcp/aws-documentation .:

{
  "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	Пользовательская строка User-Agent для HTTP-запросов	По умолчанию на основе 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 и преобразует ее в формат markdown.

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 и преобразует их в формат markdown.

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 Server.

Запуск тестов

Модульные тесты: uv run --frozen pytest --cov --cov-branch --cov-report=term-missing Модульные тесты с интеграционными тестами: uv run --frozen pytest --cov --cov-branch --cov-report=term-missing --run-live