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

{awslabs_dynamodb_mcp_server-1.0.1 → awslabs_dynamodb_mcp_server-1.0.2}/Dockerfile

@@ -13,7 +13,7 @@
 # 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
@@ -35,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
@@ -47,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.1 → 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.1
+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/

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

@@ -54,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',
 )
 
 
@@ -81,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',
@@ -94,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,
@@ -102,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(
@@ -324,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.1 → awslabs_dynamodb_mcp_server-1.0.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "awslabs.dynamodb-mcp-server"
-version = "1.0.1"
+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.1/.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]