awslabs.dynamodb-mcp-server 1.0.2__tar.gz → 1.0.4__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Potentially problematic release.
This version of awslabs.dynamodb-mcp-server might be problematic. Click here for more details.
- {awslabs_dynamodb_mcp_server-1.0.2 → awslabs_dynamodb_mcp_server-1.0.4}/Dockerfile +33 -23
- {awslabs_dynamodb_mcp_server-1.0.2 → awslabs_dynamodb_mcp_server-1.0.4}/PKG-INFO +13 -4
- {awslabs_dynamodb_mcp_server-1.0.2 → awslabs_dynamodb_mcp_server-1.0.4}/README.md +11 -2
- awslabs_dynamodb_mcp_server-1.0.4/awslabs/dynamodb_mcp_server/prompts/dynamodb_architect.md +607 -0
- {awslabs_dynamodb_mcp_server-1.0.2 → awslabs_dynamodb_mcp_server-1.0.4}/awslabs/dynamodb_mcp_server/server.py +33 -1
- {awslabs_dynamodb_mcp_server-1.0.2 → awslabs_dynamodb_mcp_server-1.0.4}/docker-healthcheck.sh +7 -8
- {awslabs_dynamodb_mcp_server-1.0.2 → awslabs_dynamodb_mcp_server-1.0.4}/pyproject.toml +2 -2
- {awslabs_dynamodb_mcp_server-1.0.2 → awslabs_dynamodb_mcp_server-1.0.4}/tests/test_dynamodb_server.py +41 -0
- awslabs_dynamodb_mcp_server-1.0.4/uv-requirements.txt +26 -0
- {awslabs_dynamodb_mcp_server-1.0.2 → awslabs_dynamodb_mcp_server-1.0.4}/uv.lock +755 -555
- {awslabs_dynamodb_mcp_server-1.0.2 → awslabs_dynamodb_mcp_server-1.0.4}/.gitignore +0 -0
- {awslabs_dynamodb_mcp_server-1.0.2 → awslabs_dynamodb_mcp_server-1.0.4}/.python-version +0 -0
- {awslabs_dynamodb_mcp_server-1.0.2 → awslabs_dynamodb_mcp_server-1.0.4}/CHANGELOG.md +0 -0
- {awslabs_dynamodb_mcp_server-1.0.2 → awslabs_dynamodb_mcp_server-1.0.4}/LICENSE +0 -0
- {awslabs_dynamodb_mcp_server-1.0.2 → awslabs_dynamodb_mcp_server-1.0.4}/NOTICE +0 -0
- {awslabs_dynamodb_mcp_server-1.0.2 → awslabs_dynamodb_mcp_server-1.0.4}/awslabs/__init__.py +0 -0
- {awslabs_dynamodb_mcp_server-1.0.2 → awslabs_dynamodb_mcp_server-1.0.4}/awslabs/dynamodb_mcp_server/__init__.py +0 -0
- {awslabs_dynamodb_mcp_server-1.0.2 → awslabs_dynamodb_mcp_server-1.0.4}/awslabs/dynamodb_mcp_server/common.py +0 -0
- {awslabs_dynamodb_mcp_server-1.0.2 → awslabs_dynamodb_mcp_server-1.0.4}/tests/test_readonly_delete_table.py +0 -0
|
@@ -12,8 +12,8 @@
|
|
|
12
12
|
# See the License for the specific language governing permissions and
|
|
13
13
|
# limitations under the License.
|
|
14
14
|
|
|
15
|
-
#
|
|
16
|
-
FROM public.ecr.aws/
|
|
15
|
+
# dependabot should continue to update this to the latest hash.
|
|
16
|
+
FROM public.ecr.aws/docker/library/python:3.13.5-alpine3.21@sha256:c9a09c45a4bcc618c7f7128585b8dd0d41d0c31a8a107db4c8255ffe0b69375d AS uv
|
|
17
17
|
|
|
18
18
|
# Install the project into `/app`
|
|
19
19
|
WORKDIR /app
|
|
@@ -31,40 +31,50 @@ ENV UV_PYTHON_PREFERENCE=only-system
|
|
|
31
31
|
ENV UV_FROZEN=true
|
|
32
32
|
|
|
33
33
|
# Copy the required files first
|
|
34
|
-
COPY pyproject.toml uv.lock ./
|
|
34
|
+
COPY pyproject.toml uv.lock uv-requirements.txt ./
|
|
35
|
+
|
|
36
|
+
# Python optimization and uv configuration
|
|
37
|
+
ENV PIP_NO_CACHE_DIR=1 \
|
|
38
|
+
PIP_DISABLE_PIP_VERSION_CHECK=1
|
|
39
|
+
|
|
40
|
+
# Install system dependencies and Python package manager
|
|
41
|
+
RUN apk update && \
|
|
42
|
+
apk add --no-cache --virtual .build-deps \
|
|
43
|
+
build-base \
|
|
44
|
+
gcc \
|
|
45
|
+
musl-dev \
|
|
46
|
+
libffi-dev \
|
|
47
|
+
openssl-dev \
|
|
48
|
+
cargo
|
|
35
49
|
|
|
36
50
|
# Install the project's dependencies using the lockfile and settings
|
|
37
51
|
RUN --mount=type=cache,target=/root/.cache/uv \
|
|
38
|
-
pip install uv
|
|
39
|
-
uv sync --frozen --no-install-project --no-dev --no-editable
|
|
52
|
+
pip install --require-hashes --requirement uv-requirements.txt --no-cache-dir && \
|
|
53
|
+
uv sync --python 3.13 --frozen --no-install-project --no-dev --no-editable
|
|
40
54
|
|
|
41
55
|
# Then, add the rest of the project source code and install it
|
|
42
56
|
# Installing separately from its dependencies allows optimal layer caching
|
|
43
57
|
COPY . /app
|
|
44
58
|
RUN --mount=type=cache,target=/root/.cache/uv \
|
|
45
|
-
uv sync --frozen --no-dev --no-editable
|
|
59
|
+
uv sync --python 3.13 --frozen --no-dev --no-editable
|
|
46
60
|
|
|
47
61
|
# Make the directory just in case it doesn't exist
|
|
48
62
|
RUN mkdir -p /root/.local
|
|
49
63
|
|
|
50
|
-
FROM public.ecr.aws/
|
|
64
|
+
FROM public.ecr.aws/docker/library/python:3.13.5-alpine3.21@sha256:c9a09c45a4bcc618c7f7128585b8dd0d41d0c31a8a107db4c8255ffe0b69375d
|
|
51
65
|
|
|
52
66
|
# Place executables in the environment at the front of the path and include other binaries
|
|
53
|
-
ENV PATH="/app/.venv/bin:$PATH
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
# Install
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
chmod o+x /root
|
|
65
|
-
|
|
66
|
-
# Get the project from the uv layer
|
|
67
|
-
COPY --from=uv --chown=app:app /root/.local /root/.local
|
|
67
|
+
ENV PATH="/app/.venv/bin:$PATH" \
|
|
68
|
+
PYTHONUNBUFFERED=1
|
|
69
|
+
|
|
70
|
+
# Install runtime dependencies and create application user
|
|
71
|
+
RUN apk update && \
|
|
72
|
+
apk add --no-cache ca-certificates && \
|
|
73
|
+
update-ca-certificates && \
|
|
74
|
+
addgroup -S app && \
|
|
75
|
+
adduser -S app -G app -h /app
|
|
76
|
+
|
|
77
|
+
# Copy application artifacts from build stage
|
|
68
78
|
COPY --from=uv --chown=app:app /app/.venv /app/.venv
|
|
69
79
|
|
|
70
80
|
# Get healthcheck script
|
|
@@ -74,5 +84,5 @@ COPY ./docker-healthcheck.sh /usr/local/bin/docker-healthcheck.sh
|
|
|
74
84
|
USER app
|
|
75
85
|
|
|
76
86
|
# When running the container, add --db-path and a bind mount to the host's db file
|
|
77
|
-
HEALTHCHECK --interval=
|
|
87
|
+
HEALTHCHECK --interval=60s --timeout=10s --start-period=10s --retries=3 CMD ["docker-healthcheck.sh"]
|
|
78
88
|
ENTRYPOINT ["awslabs.dynamodb-mcp-server"]
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: awslabs.dynamodb-mcp-server
|
|
3
|
-
Version: 1.0.
|
|
3
|
+
Version: 1.0.4
|
|
4
4
|
Summary: The official MCP Server for interacting with AWS DynamoDB
|
|
5
5
|
Project-URL: homepage, https://awslabs.github.io/mcp/
|
|
6
6
|
Project-URL: docs, https://awslabs.github.io/mcp/servers/dynamodb-mcp-server/
|
|
@@ -23,7 +23,7 @@ Classifier: Programming Language :: Python :: 3.13
|
|
|
23
23
|
Requires-Python: >=3.10
|
|
24
24
|
Requires-Dist: boto3>=1.28.0
|
|
25
25
|
Requires-Dist: loguru>=0.7.0
|
|
26
|
-
Requires-Dist: mcp[cli]>=1.
|
|
26
|
+
Requires-Dist: mcp[cli]>=1.11.0
|
|
27
27
|
Requires-Dist: pydantic>=2.10.6
|
|
28
28
|
Requires-Dist: typing-extensions>=4.0.0
|
|
29
29
|
Description-Content-Type: text/markdown
|
|
@@ -32,8 +32,13 @@ Description-Content-Type: text/markdown
|
|
|
32
32
|
|
|
33
33
|
The official MCP Server for interacting with AWS DynamoDB
|
|
34
34
|
|
|
35
|
+
This comprehensive server provides both operational DynamoDB management and expert design guidance, featuring 30+ operational tools for managing DynamoDB tables, items, indexes, backups, and more, expert data modeling guidance.
|
|
36
|
+
|
|
35
37
|
## Available MCP Tools
|
|
36
38
|
|
|
39
|
+
### Design & Modeling
|
|
40
|
+
- `dynamodb_data_modeling` - Retrieves the complete DynamoDB Data Modeling Expert prompt
|
|
41
|
+
|
|
37
42
|
### Table Operations
|
|
38
43
|
- `create_table` - Creates a new DynamoDB table with optional secondary indexes
|
|
39
44
|
- `delete_table` - Deletes a table and all of its items
|
|
@@ -80,7 +85,7 @@ The official MCP Server for interacting with AWS DynamoDB
|
|
|
80
85
|
|
|
81
86
|
## Instructions
|
|
82
87
|
|
|
83
|
-
The official MCP Server for interacting with AWS DynamoDB provides a comprehensive set of tools for
|
|
88
|
+
The official MCP Server for interacting with AWS DynamoDB provides a comprehensive set of tools for both designing and managing DynamoDB resources.
|
|
84
89
|
|
|
85
90
|
To use these tools, ensure you have proper AWS credentials configured with appropriate permissions for DynamoDB operations. The server will automatically use credentials from environment variables (AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_SESSION_TOKEN) or other standard AWS credential sources.
|
|
86
91
|
|
|
@@ -95,7 +100,11 @@ All tools support an optional `region_name` parameter to specify which AWS regio
|
|
|
95
100
|
|
|
96
101
|
## Installation
|
|
97
102
|
|
|
98
|
-
|
|
103
|
+
| Cursor | VS Code |
|
|
104
|
+
|:------:|:-------:|
|
|
105
|
+
| [](https://cursor.com/install-mcp?name=awslabs.dynamodb-mcp-server&config=eyJjb21tYW5kIjoidXZ4IGF3c2xhYnMuZHluYW1vZGItbWNwLXNlcnZlckBsYXRlc3QiLCJlbnYiOnsiRERCLU1DUC1SRUFET05MWSI6InRydWUiLCJBV1NfUFJPRklMRSI6ImRlZmF1bHQiLCJBV1NfUkVHSU9OIjoidXMtd2VzdC0yIiwiRkFTVE1DUF9MT0dfTEVWRUwiOiJFUlJPUiJ9LCJkaXNhYmxlZCI6ZmFsc2UsImF1dG9BcHByb3ZlIjpbXX0%3D) | [](https://insiders.vscode.dev/redirect/mcp/install?name=DynamoDB%20MCP%20Server&config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22awslabs.dynamodb-mcp-server%40latest%22%5D%2C%22env%22%3A%7B%22DDB-MCP-READONLY%22%3A%22true%22%2C%22AWS_PROFILE%22%3A%22default%22%2C%22AWS_REGION%22%3A%22us-west-2%22%2C%22FASTMCP_LOG_LEVEL%22%3A%22ERROR%22%7D%2C%22disabled%22%3Afalse%2C%22autoApprove%22%3A%5B%5D%7D) |
|
|
106
|
+
|
|
107
|
+
Add the MCP to your favorite agentic tools. (e.g. for Amazon Q Developer CLI MCP, `~/.aws/amazonq/mcp.json`):
|
|
99
108
|
|
|
100
109
|
```json
|
|
101
110
|
{
|
|
@@ -2,8 +2,13 @@
|
|
|
2
2
|
|
|
3
3
|
The official MCP Server for interacting with AWS DynamoDB
|
|
4
4
|
|
|
5
|
+
This comprehensive server provides both operational DynamoDB management and expert design guidance, featuring 30+ operational tools for managing DynamoDB tables, items, indexes, backups, and more, expert data modeling guidance.
|
|
6
|
+
|
|
5
7
|
## Available MCP Tools
|
|
6
8
|
|
|
9
|
+
### Design & Modeling
|
|
10
|
+
- `dynamodb_data_modeling` - Retrieves the complete DynamoDB Data Modeling Expert prompt
|
|
11
|
+
|
|
7
12
|
### Table Operations
|
|
8
13
|
- `create_table` - Creates a new DynamoDB table with optional secondary indexes
|
|
9
14
|
- `delete_table` - Deletes a table and all of its items
|
|
@@ -50,7 +55,7 @@ The official MCP Server for interacting with AWS DynamoDB
|
|
|
50
55
|
|
|
51
56
|
## Instructions
|
|
52
57
|
|
|
53
|
-
The official MCP Server for interacting with AWS DynamoDB provides a comprehensive set of tools for
|
|
58
|
+
The official MCP Server for interacting with AWS DynamoDB provides a comprehensive set of tools for both designing and managing DynamoDB resources.
|
|
54
59
|
|
|
55
60
|
To use these tools, ensure you have proper AWS credentials configured with appropriate permissions for DynamoDB operations. The server will automatically use credentials from environment variables (AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_SESSION_TOKEN) or other standard AWS credential sources.
|
|
56
61
|
|
|
@@ -65,7 +70,11 @@ All tools support an optional `region_name` parameter to specify which AWS regio
|
|
|
65
70
|
|
|
66
71
|
## Installation
|
|
67
72
|
|
|
68
|
-
|
|
73
|
+
| Cursor | VS Code |
|
|
74
|
+
|:------:|:-------:|
|
|
75
|
+
| [](https://cursor.com/install-mcp?name=awslabs.dynamodb-mcp-server&config=eyJjb21tYW5kIjoidXZ4IGF3c2xhYnMuZHluYW1vZGItbWNwLXNlcnZlckBsYXRlc3QiLCJlbnYiOnsiRERCLU1DUC1SRUFET05MWSI6InRydWUiLCJBV1NfUFJPRklMRSI6ImRlZmF1bHQiLCJBV1NfUkVHSU9OIjoidXMtd2VzdC0yIiwiRkFTVE1DUF9MT0dfTEVWRUwiOiJFUlJPUiJ9LCJkaXNhYmxlZCI6ZmFsc2UsImF1dG9BcHByb3ZlIjpbXX0%3D) | [](https://insiders.vscode.dev/redirect/mcp/install?name=DynamoDB%20MCP%20Server&config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22awslabs.dynamodb-mcp-server%40latest%22%5D%2C%22env%22%3A%7B%22DDB-MCP-READONLY%22%3A%22true%22%2C%22AWS_PROFILE%22%3A%22default%22%2C%22AWS_REGION%22%3A%22us-west-2%22%2C%22FASTMCP_LOG_LEVEL%22%3A%22ERROR%22%7D%2C%22disabled%22%3Afalse%2C%22autoApprove%22%3A%5B%5D%7D) |
|
|
76
|
+
|
|
77
|
+
Add the MCP to your favorite agentic tools. (e.g. for Amazon Q Developer CLI MCP, `~/.aws/amazonq/mcp.json`):
|
|
69
78
|
|
|
70
79
|
```json
|
|
71
80
|
{
|