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.

Files changed (19) hide show
  1. {awslabs_dynamodb_mcp_server-1.0.2 → awslabs_dynamodb_mcp_server-1.0.4}/Dockerfile +33 -23
  2. {awslabs_dynamodb_mcp_server-1.0.2 → awslabs_dynamodb_mcp_server-1.0.4}/PKG-INFO +13 -4
  3. {awslabs_dynamodb_mcp_server-1.0.2 → awslabs_dynamodb_mcp_server-1.0.4}/README.md +11 -2
  4. awslabs_dynamodb_mcp_server-1.0.4/awslabs/dynamodb_mcp_server/prompts/dynamodb_architect.md +607 -0
  5. {awslabs_dynamodb_mcp_server-1.0.2 → awslabs_dynamodb_mcp_server-1.0.4}/awslabs/dynamodb_mcp_server/server.py +33 -1
  6. {awslabs_dynamodb_mcp_server-1.0.2 → awslabs_dynamodb_mcp_server-1.0.4}/docker-healthcheck.sh +7 -8
  7. {awslabs_dynamodb_mcp_server-1.0.2 → awslabs_dynamodb_mcp_server-1.0.4}/pyproject.toml +2 -2
  8. {awslabs_dynamodb_mcp_server-1.0.2 → awslabs_dynamodb_mcp_server-1.0.4}/tests/test_dynamodb_server.py +41 -0
  9. awslabs_dynamodb_mcp_server-1.0.4/uv-requirements.txt +26 -0
  10. {awslabs_dynamodb_mcp_server-1.0.2 → awslabs_dynamodb_mcp_server-1.0.4}/uv.lock +755 -555
  11. {awslabs_dynamodb_mcp_server-1.0.2 → awslabs_dynamodb_mcp_server-1.0.4}/.gitignore +0 -0
  12. {awslabs_dynamodb_mcp_server-1.0.2 → awslabs_dynamodb_mcp_server-1.0.4}/.python-version +0 -0
  13. {awslabs_dynamodb_mcp_server-1.0.2 → awslabs_dynamodb_mcp_server-1.0.4}/CHANGELOG.md +0 -0
  14. {awslabs_dynamodb_mcp_server-1.0.2 → awslabs_dynamodb_mcp_server-1.0.4}/LICENSE +0 -0
  15. {awslabs_dynamodb_mcp_server-1.0.2 → awslabs_dynamodb_mcp_server-1.0.4}/NOTICE +0 -0
  16. {awslabs_dynamodb_mcp_server-1.0.2 → awslabs_dynamodb_mcp_server-1.0.4}/awslabs/__init__.py +0 -0
  17. {awslabs_dynamodb_mcp_server-1.0.2 → awslabs_dynamodb_mcp_server-1.0.4}/awslabs/dynamodb_mcp_server/__init__.py +0 -0
  18. {awslabs_dynamodb_mcp_server-1.0.2 → awslabs_dynamodb_mcp_server-1.0.4}/awslabs/dynamodb_mcp_server/common.py +0 -0
  19. {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
- #FROM public.ecr.aws/sam/build-python3.10:1.137.1-20250411084548
16
- FROM public.ecr.aws/sam/build-python3.10@sha256:d821662474d65f3cf2fc97dba2fa807a3adb580d02895fc4545527812550ea65 AS uv
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==0.7.11 && \
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/sam/build-python3.10@sha256:d821662474d65f3cf2fc97dba2fa807a3adb580d02895fc4545527812550ea65
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:/usr/sbin"
54
-
55
- # Install lsof for the healthcheck
56
- # Install other tools as needed for the MCP server
57
- # Add non-root user and ability to change directory into /root
58
- RUN yum update -y && \
59
- yum install -y lsof && \
60
- yum clean all -y && \
61
- rm -rf /var/cache/yum && \
62
- groupadd --force --system app && \
63
- useradd app -g app -d /app && \
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=30s --timeout=30s --start-period=5s --retries=3 CMD [ "docker-healthcheck.sh" ]
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.2
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.6.0
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 managing DynamoDB resources. Each tool maps directly to DynamoDB API operations and supports all relevant parameters.
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
- Add the MCP to your favorite agentic tools. e.g. for Amazon Q Developer CLI MCP, `~/.aws/amazonq/mcp.json`):
103
+ | Cursor | VS Code |
104
+ |:------:|:-------:|
105
+ | [![Install MCP Server](https://cursor.com/deeplink/mcp-install-light.svg)](https://cursor.com/install-mcp?name=awslabs.dynamodb-mcp-server&config=eyJjb21tYW5kIjoidXZ4IGF3c2xhYnMuZHluYW1vZGItbWNwLXNlcnZlckBsYXRlc3QiLCJlbnYiOnsiRERCLU1DUC1SRUFET05MWSI6InRydWUiLCJBV1NfUFJPRklMRSI6ImRlZmF1bHQiLCJBV1NfUkVHSU9OIjoidXMtd2VzdC0yIiwiRkFTVE1DUF9MT0dfTEVWRUwiOiJFUlJPUiJ9LCJkaXNhYmxlZCI6ZmFsc2UsImF1dG9BcHByb3ZlIjpbXX0%3D) | [![Install on VS Code](https://img.shields.io/badge/Install_on-VS_Code-FF9900?style=flat-square&logo=visualstudiocode&logoColor=white)](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 managing DynamoDB resources. Each tool maps directly to DynamoDB API operations and supports all relevant parameters.
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
- Add the MCP to your favorite agentic tools. e.g. for Amazon Q Developer CLI MCP, `~/.aws/amazonq/mcp.json`):
73
+ | Cursor | VS Code |
74
+ |:------:|:-------:|
75
+ | [![Install MCP Server](https://cursor.com/deeplink/mcp-install-light.svg)](https://cursor.com/install-mcp?name=awslabs.dynamodb-mcp-server&config=eyJjb21tYW5kIjoidXZ4IGF3c2xhYnMuZHluYW1vZGItbWNwLXNlcnZlckBsYXRlc3QiLCJlbnYiOnsiRERCLU1DUC1SRUFET05MWSI6InRydWUiLCJBV1NfUFJPRklMRSI6ImRlZmF1bHQiLCJBV1NfUkVHSU9OIjoidXMtd2VzdC0yIiwiRkFTVE1DUF9MT0dfTEVWRUwiOiJFUlJPUiJ9LCJkaXNhYmxlZCI6ZmFsc2UsImF1dG9BcHByb3ZlIjpbXX0%3D) | [![Install on VS Code](https://img.shields.io/badge/Install_on-VS_Code-FF9900?style=flat-square&logo=visualstudiocode&logoColor=white)](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
  {