dynamodb — MCP-сервер для Claude Code: что делает и как установить
Даёт ИИ-агенту прямой доступ к таблицам AWS DynamoDB или LocalStack с разделением прав на чтение, запись и администрирование.
claude mcp add --env AWS_REGION=<AWS_REGION> --env AWS_ACCESS_KEY_ID=<AWS_ACCESS_KEY_ID> --env AWS_SECRET_ACCESS_KEY=<AWS_SECRET_ACCESS_KEY> --env DYNAMODB_ENDPOINT=<DYNAMODB_ENDPOINT> --env DYNAMODB_ENABLED_TOOL_GROUPS=<DYNAMODB_ENABLED_TOOL_GROUPS> --transport stdio dynamodb -- npx -y aws-dynamodb-mcp-serverЧто делает dynamodb
Сервер связывает клиент с базой DynamoDB через пакет aws-dynamodb-mcp-server. Ассистент получает команды для чтения записей, выборки по ключам, сканирования таблиц и пакетных операций. Для изменения схемы доступны вызовы создания и удаления таблиц.
Доступ настраивается через переменные окружения. Можно подключить сразу группу readonly или составить список разрешённых утилит в DYNAMODB_ENABLED_TOOLS. Если задать DYNAMODB_ALLOWED_TABLES, агент увидит только указанные таблицы. При этом имена таблиц сверяются с учётом регистра букв: несовпадение регистра приведёт к ошибке доступа.
Работать можно как с облаком AWS, так и с локальным эмулятором через переменную DYNAMODB_ENDPOINT. Переменная AWS_REGION обязательна во всех конфигурациях.
Какие задачи решает
- прочитать записи и метаданные таблицы по первичному ключу
- выполнить запрос к таблице с условиями фильтрации
- ограничить агенту доступ только чтением без права удаления
- протестировать запросы к локальному эмулятору LocalStack
Примеры запросов агенту
- Покажи список всех таблиц в текущем регионе AWS.
- Найди в таблице Orders все заказы клиента C123 за последний месяц.
- Создай таблицу Users со строковым ключом userId в режиме Pay per request.
Как установить dynamodb
Командой платформы
claude mcp add --env AWS_REGION=<AWS_REGION> --env AWS_ACCESS_KEY_ID=<AWS_ACCESS_KEY_ID> --env AWS_SECRET_ACCESS_KEY=<AWS_SECRET_ACCESS_KEY> --env DYNAMODB_ENDPOINT=<DYNAMODB_ENDPOINT> --env DYNAMODB_ENABLED_TOOL_GROUPS=<DYNAMODB_ENABLED_TOOL_GROUPS> --transport stdio dynamodb -- npx -y aws-dynamodb-mcp-serverВместо <…> подставьте свои значения. Ещё 4 переменные окружения — в README сервера
Командой платформы
codex mcp add dynamodb --env AWS_REGION=<AWS_REGION> --env AWS_ACCESS_KEY_ID=<AWS_ACCESS_KEY_ID> --env AWS_SECRET_ACCESS_KEY=<AWS_SECRET_ACCESS_KEY> --env DYNAMODB_ENDPOINT=<DYNAMODB_ENDPOINT> --env DYNAMODB_ENABLED_TOOL_GROUPS=<DYNAMODB_ENABLED_TOOL_GROUPS> -- npx -y aws-dynamodb-mcp-serverВместо <…> подставьте свои значения. Ещё 4 переменные окружения — в README сервера
Файл настроек
{
"mcpServers": {
"dynamodb": {
"command": "npx",
"args": [
"-y",
"aws-dynamodb-mcp-server"
],
"env": {
"AWS_REGION": "<AWS_REGION>",
"AWS_ACCESS_KEY_ID": "<AWS_ACCESS_KEY_ID>",
"AWS_SECRET_ACCESS_KEY": "<AWS_SECRET_ACCESS_KEY>",
"DYNAMODB_ENDPOINT": "<DYNAMODB_ENDPOINT>",
"DYNAMODB_ENABLED_TOOL_GROUPS": "<DYNAMODB_ENABLED_TOOL_GROUPS>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 4 переменные окружения — в README сервера
Файл настроек
{
"servers": {
"dynamodb": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"aws-dynamodb-mcp-server"
],
"env": {
"AWS_REGION": "<AWS_REGION>",
"AWS_ACCESS_KEY_ID": "<AWS_ACCESS_KEY_ID>",
"AWS_SECRET_ACCESS_KEY": "<AWS_SECRET_ACCESS_KEY>",
"DYNAMODB_ENDPOINT": "<DYNAMODB_ENDPOINT>",
"DYNAMODB_ENABLED_TOOL_GROUPS": "<DYNAMODB_ENABLED_TOOL_GROUPS>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 4 переменные окружения — в README сервера
Командой платформы
gemini mcp add -e AWS_REGION=<AWS_REGION> -e AWS_ACCESS_KEY_ID=<AWS_ACCESS_KEY_ID> -e AWS_SECRET_ACCESS_KEY=<AWS_SECRET_ACCESS_KEY> -e DYNAMODB_ENDPOINT=<DYNAMODB_ENDPOINT> -e DYNAMODB_ENABLED_TOOL_GROUPS=<DYNAMODB_ENABLED_TOOL_GROUPS> dynamodb npx -y aws-dynamodb-mcp-serverВместо <…> подставьте свои значения. Ещё 4 переменные окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о dynamodb
Как установить dynamodb в Claude Code?
Выполните команду `claude mcp add dynamodb -e AWS_REGION=<AWS_REGION> -e AWS_ACCESS_KEY_ID=<AWS_ACCESS_KEY_ID> -e AWS_SECRET_ACCESS_KEY=<AWS_SECRET_ACCESS_KEY> -- npx -y aws-dynamodb-mcp-server`. Вместо плейсхолдеров подставьте свои данные доступа AWS.
Что делает MCP-сервер dynamodb?
Предоставляет ассистенту инструменты для чтения, записи и изменения таблиц DynamoDB. Уровень доступа можно сузить до конкретных таблиц или операций только для чтения.
Можно ли подключить локальную базу DynamoDB?
Да, для этого нужно задать переменную DYNAMODB_ENDPOINT, указав адрес локального сервиса или контейнера LocalStack (например, http://localhost:8000).
