awslabs.dynamodb-mcp-server 1.0.0__tar.gz → 1.0.2__tar.gz

{awslabs_dynamodb_mcp_server-1.0.0 → awslabs_dynamodb_mcp_server-1.0.2}/Dockerfile

@@ -1,16 +1,19 @@
 # Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
 #
-# Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance
-# with the License. A copy of the License is located at
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
 #
-#    http://www.apache.org/licenses/LICENSE-2.0
+#     http://www.apache.org/licenses/LICENSE-2.0
 #
-# or in the 'license' file accompanying this file. This file is distributed on an 'AS IS' BASIS, WITHOUT WARRANTIES
-# OR CONDITIONS OF ANY KIND, express or implied. See the License for the specific language governing permissions
-# and limitations under the License.
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
 
 #FROM public.ecr.aws/sam/build-python3.10:1.137.1-20250411084548
-FROM public.ecr.aws/sam/build-python3.10@sha256:e78695db10ca8cb129e59e30f7dc9789b0dbd0181dba195d68419c72bac51ac1 AS uv
+FROM public.ecr.aws/sam/build-python3.10@sha256:d821662474d65f3cf2fc97dba2fa807a3adb580d02895fc4545527812550ea65 AS uv
 
 # Install the project into `/app`
 WORKDIR /app
@@ -32,7 +35,7 @@ COPY pyproject.toml uv.lock ./
 
 # Install the project's dependencies using the lockfile and settings
 RUN --mount=type=cache,target=/root/.cache/uv \
-    pip install uv && \
+    pip install uv==0.7.11 && \
     uv sync --frozen --no-install-project --no-dev --no-editable
 
 # Then, add the rest of the project source code and install it
@@ -44,7 +47,7 @@ RUN --mount=type=cache,target=/root/.cache/uv \
 # Make the directory just in case it doesn't exist
 RUN mkdir -p /root/.local
 
-FROM public.ecr.aws/sam/build-python3.10@sha256:e78695db10ca8cb129e59e30f7dc9789b0dbd0181dba195d68419c72bac51ac1
+FROM public.ecr.aws/sam/build-python3.10@sha256:d821662474d65f3cf2fc97dba2fa807a3adb580d02895fc4545527812550ea65
 
 # Place executables in the environment at the front of the path and include other binaries
 ENV PATH="/app/.venv/bin:$PATH:/usr/sbin"

{awslabs_dynamodb_mcp_server-1.0.0 → awslabs_dynamodb_mcp_server-1.0.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: awslabs.dynamodb-mcp-server
-Version: 1.0.0
+Version: 1.0.2
 Summary: The official MCP Server for interacting with AWS DynamoDB
 Project-URL: homepage, https://awslabs.github.io/mcp/
 Project-URL: docs, https://awslabs.github.io/mcp/servers/dynamodb-mcp-server/
@@ -116,7 +116,7 @@ Add the MCP to your favorite agentic tools. e.g. for Amazon Q Developer CLI MCP,
 }
 ```
 
-or docker after a succesful `docker build -t awslabs/dynamodb-mcp-server .`:
+or docker after a successful `docker build -t awslabs/dynamodb-mcp-server .`:
 
 ```json
   {

{awslabs_dynamodb_mcp_server-1.0.0 → awslabs_dynamodb_mcp_server-1.0.2}/README.md

@@ -86,7 +86,7 @@ Add the MCP to your favorite agentic tools. e.g. for Amazon Q Developer CLI MCP,
 }
 ```
 
-or docker after a succesful `docker build -t awslabs/dynamodb-mcp-server .`:
+or docker after a successful `docker build -t awslabs/dynamodb-mcp-server .`:
 
 ```json
   {

awslabs_dynamodb_mcp_server-1.0.2/awslabs/__init__.py

@@ -0,0 +1,16 @@
+# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# This file is part of the awslabs namespace.
+# It is intentionally minimal to support PEP 420 namespace packages.

awslabs_dynamodb_mcp_server-1.0.2/awslabs/dynamodb_mcp_server/__init__.py

@@ -0,0 +1,17 @@
+# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""awslabs.dynamodb-mcp-server"""
+
+__version__ = '0.0.0'

{awslabs_dynamodb_mcp_server-1.0.0 → awslabs_dynamodb_mcp_server-1.0.2}/awslabs/dynamodb_mcp_server/common.py

@@ -1,3 +1,17 @@
+# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
 import os
 from functools import wraps
 from typing import Any, Callable, Dict, List, Literal, Optional

{awslabs_dynamodb_mcp_server-1.0.0 → awslabs_dynamodb_mcp_server-1.0.2}/awslabs/dynamodb_mcp_server/server.py

@@ -1,3 +1,17 @@
+# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
 #!/usr/bin/env python3
 
 import boto3
@@ -40,8 +54,51 @@ from typing import Any, Dict, List, Literal, Union
 
 app = FastMCP(
     name='dynamodb-server',
-    instructions='The official MCP Server for interacting with AWS DynamoDB',
-    version='0.1.1',
+    instructions="""The official MCP Server for interacting with AWS DynamoDB
+
+IMPORTANT: DynamoDB Attribute Value Format
+-----------------------------------------
+When working with DynamoDB, all attribute values must be specified with their data types.
+Each attribute value is represented as a dictionary with a single key-value pair where the key
+is the data type and the value is the data itself:
+
+- S: String
+  Example: {"S": "Hello"}
+
+- N: Number (sent as a string)
+  Example: {"N": "123.45"}
+
+- B: Binary data (Base64-encoded)
+  Example: {"B": "dGhpcyB0ZXh0IGlzIGJhc2U2NC1lbmNvZGVk"}
+
+- BOOL: Boolean value
+  Example: {"BOOL": true}
+
+- NULL: Null value
+  Example: {"NULL": true}
+
+- L: List of AttributeValue objects
+  Example: {"L": [{"S": "Cookies"}, {"S": "Coffee"}, {"N": "3.14159"}]}
+
+- M: Map of attribute name/value pairs
+  Example: {"M": {"Name": {"S": "Joe"}, "Age": {"N": "35"}}}
+
+- SS: String Set (array of strings)
+  Example: {"SS": ["Giraffe", "Hippo", "Zebra"]}
+
+- NS: Number Set (array of strings representing numbers)
+  Example: {"NS": ["42.2", "-19", "7.5", "3.14"]}
+
+- BS: Binary Set (array of Base64-encoded binary data objects)
+  Example: {"BS": ["U3Vubnk=", "UmFpbnk=", "U25vd3k="]}
+
+Common usage examples:
+- Primary key: {"userId": {"S": "user123"}}
+- Composite key: {"userId": {"S": "user123"}, "timestamp": {"N": "1612345678"}}
+- Expression attribute values: {":minScore": {"N": "100"}, ":active": {"BOOL": true}}
+- Complete item: {"userId": {"S": "user123"}, "score": {"N": "100"}, "data": {"B": "binarydata=="}}
+""",
+    version='0.1.2',
 )
 
 
@@ -67,7 +124,9 @@ index_name = Field(
     default=None,
     description='The name of a GSI',
 )
-key: Dict[str, KeyAttributeValue] = Field(description='The primary key of an item')
+key: Dict[str, KeyAttributeValue] = Field(
+    description='The primary key of an item. Must use DynamoDB attribute value format (see IMPORTANT note about DynamoDB Attribute Value Format).'
+)
 filter_expression: str = Field(
     default=None,
     description='Filter conditions expression that DynamoDB applies to filter out data',
@@ -80,7 +139,8 @@ expression_attribute_names: Dict[str, str] = Field(
     default=None, description='Substitution tokens for attribute names in an expression.'
 )
 expression_attribute_values: Dict[str, AttributeValue] = Field(
-    default=None, description='Values that can be substituted in an expression'
+    default=None,
+    description='Values that can be substituted in an expression. Must use DynamoDB attribute value format (see IMPORTANT note about DynamoDB Attribute Value Format).',
 )
 select: Select = Field(
     default=None,
@@ -88,7 +148,8 @@ select: Select = Field(
 )
 limit: int = Field(default=None, description='The maximum number of items to evaluate', ge=1)
 exclusive_start_key: Dict[str, KeyAttributeValue] = Field(
-    default=None, description='Use the LastEvaluatedKey from the previous call.'
+    default=None,
+    description='Use the LastEvaluatedKey from the previous call. Must use DynamoDB attribute value format (see IMPORTANT note about DynamoDB Attribute Value Format).',
 )
 
 billing_mode: Literal['PROVISIONED', 'PAY_PER_REQUEST'] = Field(
@@ -310,7 +371,7 @@ async def get_item(
 async def put_item(
     table_name: str = table_name,
     item: Dict[str, AttributeValue] = Field(
-        description='A map of attribute name/value pairs, one for each attribute.'
+        description='A map of attribute name/value pairs, one for each attribute. Must use DynamoDB attribute value format (see IMPORTANT note about DynamoDB Attribute Value Format).'
     ),
     condition_expression: str = Field(
         default=None,

awslabs_dynamodb_mcp_server-1.0.2/docker-healthcheck.sh

@@ -0,0 +1,26 @@
+#!/bin/sh
+
+# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+if [ "$(lsof +c 0 -p 1 | grep -e "^awslabs\..*\s1\s.*\sunix\s.*socket$" | wc -l)" -ne "0" ]; then
+  echo -n "$(lsof +c 0 -p 1 | grep -e "^awslabs\..*\s1\s.*\sunix\s.*socket$" | wc -l) awslabs.* streams found";
+  exit 0;
+else
+  echo -n "Zero awslabs.* streams found";
+  exit 1;
+fi;
+
+echo -n "Never should reach here";
+exit 99;

{awslabs_dynamodb_mcp_server-1.0.0 → awslabs_dynamodb_mcp_server-1.0.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "awslabs.dynamodb-mcp-server"
-version = "1.0.0"
+version = "1.0.2"
 description = "The official MCP Server for interacting with AWS DynamoDB"
 readme = "README.md"
 requires-python = ">=3.10"

awslabs_dynamodb_mcp_server-1.0.0/.pre-commit-config.yaml

@@ -1,14 +0,0 @@
-repos:
-  - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.9.6
-    hooks:
-      - id: ruff
-        args: [--fix]
-      - id: ruff-format
-
-  - repo: https://github.com/commitizen-tools/commitizen
-    rev: v3.13.0
-    hooks:
-      - id: commitizen
-      - id: commitizen-branch
-        stages: [push]

awslabs_dynamodb_mcp_server-1.0.0/awslabs/__init__.py

@@ -1,13 +0,0 @@
-# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
-#
-# Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance
-# with the License. A copy of the License is located at
-#
-#    http://www.apache.org/licenses/LICENSE-2.0
-#
-# or in the 'license' file accompanying this file. This file is distributed on an 'AS IS' BASIS, WITHOUT WARRANTIES
-# OR CONDITIONS OF ANY KIND, express or implied. See the License for the specific language governing permissions
-# and limitations under the License.
-
-# This file is part of the awslabs namespace.
-# It is intentionally minimal to support PEP 420 namespace packages.

awslabs_dynamodb_mcp_server-1.0.0/awslabs/dynamodb_mcp_server/__init__.py

@@ -1,14 +0,0 @@
-# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
-#
-# Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance
-# with the License. A copy of the License is located at
-#
-#    http://www.apache.org/licenses/LICENSE-2.0
-#
-# or in the 'license' file accompanying this file. This file is distributed on an 'AS IS' BASIS, WITHOUT WARRANTIES
-# OR CONDITIONS OF ANY KIND, express or implied. See the License for the specific language governing permissions
-# and limitations under the License.
-
-"""awslabs.dynamodb-mcp-server"""
-
-__version__ = '0.0.0'

awslabs_dynamodb_mcp_server-1.0.0/docker-healthcheck.sh

@@ -1,12 +0,0 @@
-#!/bin/sh
-
-if [ "$(lsof +c 0 -p 1 | grep -e "^awslabs\..*\s1\s.*\sunix\s.*socket$" | wc -l)" -ne "0" ]; then
-  echo -n "$(lsof +c 0 -p 1 | grep -e "^awslabs\..*\s1\s.*\sunix\s.*socket$" | wc -l) awslabs.* streams found";
-  exit 0;
-else
-  echo -n "Zero awslabs.* streams found";
-  exit 1;
-fi;
-
-echo -n "Never should reach here";
-exit 99;