s3 — MCP-сервер для Claude Code: что делает и как установить
MCP-сервер даёт агенту доступ к AWS S3 и совместимым хранилищам. Подходит для чтения, загрузки, копирования и удаления объектов с ограничением прав.
claude mcp add --env AWS_ACCESS_KEY_ID=<AWS_ACCESS_KEY_ID> --env AWS_SECRET_ACCESS_KEY=<AWS_SECRET_ACCESS_KEY> --env AWS_REGION=<AWS_REGION> --env AWS_ENDPOINT_URL=<AWS_ENDPOINT_URL> --env S3_FORCE_PATH_STYLE=<S3_FORCE_PATH_STYLE> --transport stdio s3 -- npx -y s3-aws-mcp-serverЧто делает s3
Сервер подключает к агенту операции с бакетами и объектами S3: просмотр бакетов, поиск объектов по префиксу, чтение содержимого, загрузку, копирование и удаление. Он также проверяет доступ AWS и предоставляет ресурс s3://config со статусом и конфигурацией.
Права можно разделить на группы readonly и readwrite, а отдельные инструменты включать или отключать через переменные окружения. Переменная S3_BUCKET ограничивает работу одним бакетом и скрывает операции уровня бакетов. Для AWS нужны AWS_ACCESS_KEY_ID и AWS_SECRET_ACCESS_KEY; для MinIO и похожих сервисов задайте AWS_ENDPOINT_URL и S3_FORCE_PATH_STYLE=true. Без ключей AWS сервер не пройдёт проверку учётных данных.
Какие задачи решает
- просматривать бакеты и объекты S3
- читать содержимое объектов по запросу агента
- загружать или обновлять файлы в бакете
- копировать объекты между бакетами
- ограничивать доступ одним бакетом
Примеры запросов агенту
- Покажи бакеты AWS и проверь доступ к ним.
- Прочитай объект из бакета с нужным префиксом и кратко опиши его содержимое.
- Загрузи подготовленный файл в указанный бакет, не включая операции удаления.
Как установить s3
Командой платформы
claude mcp add --env AWS_ACCESS_KEY_ID=<AWS_ACCESS_KEY_ID> --env AWS_SECRET_ACCESS_KEY=<AWS_SECRET_ACCESS_KEY> --env AWS_REGION=<AWS_REGION> --env AWS_ENDPOINT_URL=<AWS_ENDPOINT_URL> --env S3_FORCE_PATH_STYLE=<S3_FORCE_PATH_STYLE> --transport stdio s3 -- npx -y s3-aws-mcp-serverВместо <…> подставьте свои значения. Ещё 5 переменных окружения — в README сервера
Командой платформы
codex mcp add s3 --env AWS_ACCESS_KEY_ID=<AWS_ACCESS_KEY_ID> --env AWS_SECRET_ACCESS_KEY=<AWS_SECRET_ACCESS_KEY> --env AWS_REGION=<AWS_REGION> --env AWS_ENDPOINT_URL=<AWS_ENDPOINT_URL> --env S3_FORCE_PATH_STYLE=<S3_FORCE_PATH_STYLE> -- npx -y s3-aws-mcp-serverВместо <…> подставьте свои значения. Ещё 5 переменных окружения — в README сервера
Файл настроек
{
"mcpServers": {
"s3": {
"command": "npx",
"args": [
"-y",
"s3-aws-mcp-server"
],
"env": {
"AWS_ACCESS_KEY_ID": "<AWS_ACCESS_KEY_ID>",
"AWS_SECRET_ACCESS_KEY": "<AWS_SECRET_ACCESS_KEY>",
"AWS_REGION": "<AWS_REGION>",
"AWS_ENDPOINT_URL": "<AWS_ENDPOINT_URL>",
"S3_FORCE_PATH_STYLE": "<S3_FORCE_PATH_STYLE>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 5 переменных окружения — в README сервера
Файл настроек
{
"servers": {
"s3": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"s3-aws-mcp-server"
],
"env": {
"AWS_ACCESS_KEY_ID": "<AWS_ACCESS_KEY_ID>",
"AWS_SECRET_ACCESS_KEY": "<AWS_SECRET_ACCESS_KEY>",
"AWS_REGION": "<AWS_REGION>",
"AWS_ENDPOINT_URL": "<AWS_ENDPOINT_URL>",
"S3_FORCE_PATH_STYLE": "<S3_FORCE_PATH_STYLE>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 5 переменных окружения — в README сервера
Командой платформы
gemini mcp add -e AWS_ACCESS_KEY_ID=<AWS_ACCESS_KEY_ID> -e AWS_SECRET_ACCESS_KEY=<AWS_SECRET_ACCESS_KEY> -e AWS_REGION=<AWS_REGION> -e AWS_ENDPOINT_URL=<AWS_ENDPOINT_URL> -e S3_FORCE_PATH_STYLE=<S3_FORCE_PATH_STYLE> s3 npx -y s3-aws-mcp-serverВместо <…> подставьте свои значения. Ещё 5 переменных окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о s3
Как установить s3 в Claude Code?
Выполните claude mcp add s3 -e AWS_ACCESS_KEY_ID=<AWS_ACCESS_KEY_ID> -e AWS_SECRET_ACCESS_KEY=<AWS_SECRET_ACCESS_KEY> -- npx -y s3-aws-mcp-server.
Что делает MCP-сервер s3?
Он даёт агенту инструменты для работы с бакетами и объектами S3: чтения, загрузки, копирования, удаления и проверки доступа. Доступ к операциям можно ограничить группой инструментов или отдельными переменными.
Как ограничить сервер одним бакетом?
Задайте S3_BUCKET. Объектные операции будут работать только с этим бакетом, а инструменты для списка, создания и удаления бакетов скроются.
