awslabs.valkey-mcp-server 1.0.2__tar.gz → 1.0.4__tar.gz

{awslabs_valkey_mcp_server-1.0.2 → awslabs_valkey_mcp_server-1.0.4}/Dockerfile

@@ -12,8 +12,8 @@
 # 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:d821662474d65f3cf2fc97dba2fa807a3adb580d02895fc4545527812550ea65 AS uv
+# dependabot should continue to update this to the latest hash.
+FROM public.ecr.aws/docker/library/python:3.13.5-alpine3.21@sha256:c9a09c45a4bcc618c7f7128585b8dd0d41d0c31a8a107db4c8255ffe0b69375d AS uv
 
 # Install the project into `/app`
 WORKDIR /app
@@ -31,40 +31,50 @@ ENV UV_PYTHON_PREFERENCE=only-system
 ENV UV_FROZEN=true
 
 # Copy the required files first
-COPY pyproject.toml uv.lock ./
+COPY pyproject.toml uv.lock uv-requirements.txt ./
+
+# Python optimization and uv configuration
+ENV PIP_NO_CACHE_DIR=1 \
+    PIP_DISABLE_PIP_VERSION_CHECK=1
+
+# Install system dependencies and Python package manager
+RUN apk update && \
+    apk add --no-cache --virtual .build-deps \
+    build-base \
+    gcc \
+    musl-dev \
+    libffi-dev \
+    openssl-dev \
+    cargo
 
 # Install the project's dependencies using the lockfile and settings
 RUN --mount=type=cache,target=/root/.cache/uv \
-    pip install uv==0.7.11 && \
-    uv sync --frozen --no-install-project --no-dev --no-editable
+    pip install --require-hashes --requirement uv-requirements.txt --no-cache-dir && \
+    uv sync --python 3.13 --frozen --no-install-project --no-dev --no-editable
 
 # Then, add the rest of the project source code and install it
 # Installing separately from its dependencies allows optimal layer caching
 COPY . /app
 RUN --mount=type=cache,target=/root/.cache/uv \
-    uv sync --frozen --no-dev --no-editable
+    uv sync --python 3.13 --frozen --no-dev --no-editable
 
 # Make the directory just in case it doesn't exist
 RUN mkdir -p /root/.local
 
-FROM public.ecr.aws/sam/build-python3.10@sha256:d821662474d65f3cf2fc97dba2fa807a3adb580d02895fc4545527812550ea65
+FROM public.ecr.aws/docker/library/python:3.13.5-alpine3.21@sha256:c9a09c45a4bcc618c7f7128585b8dd0d41d0c31a8a107db4c8255ffe0b69375d
 
 # Place executables in the environment at the front of the path and include other binaries
-ENV PATH="/app/.venv/bin:$PATH:/usr/sbin"
-
-# Install lsof for the healthcheck
-# Install other tools as needed for the MCP server
-# Add non-root user and ability to change directory into /root
-RUN yum update -y && \
-    yum install -y lsof && \
-    yum clean all -y && \
-    rm -rf /var/cache/yum && \
-    groupadd --force --system app && \
-    useradd app -g app -d /app && \
-    chmod o+x /root
-
-# Get the project from the uv layer
-COPY --from=uv --chown=app:app /root/.local /root/.local
+ENV PATH="/app/.venv/bin:$PATH" \
+    PYTHONUNBUFFERED=1
+
+# Install runtime dependencies and create application user
+RUN apk update && \
+    apk add --no-cache ca-certificates && \
+    update-ca-certificates && \
+    addgroup -S app && \
+    adduser -S app -G app -h /app
+
+# Copy application artifacts from build stage
 COPY --from=uv --chown=app:app /app/.venv /app/.venv
 
 # Get healthcheck script
@@ -73,6 +83,6 @@ COPY ./docker-healthcheck.sh /usr/local/bin/docker-healthcheck.sh
 # Run as non-root
 USER app
 
-# When running the container, add --valkey-host and --valkey-port to connect to Valkey server
-HEALTHCHECK --interval=30s --timeout=30s --start-period=5s --retries=3 CMD [ "docker-healthcheck.sh" ]
+# When running the container, add --db-path and a bind mount to the host's db file
+HEALTHCHECK --interval=60s --timeout=10s --start-period=10s --retries=3 CMD ["docker-healthcheck.sh"]
 ENTRYPOINT ["awslabs.valkey-mcp-server"]

{awslabs_valkey_mcp_server-1.0.2 → awslabs_valkey_mcp_server-1.0.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: awslabs.valkey-mcp-server
-Version: 1.0.2
+Version: 1.0.4
 Summary: An AWS Labs Model Context Protocol (MCP) server for valkey
 Project-URL: homepage, https://awslabs.github.io/mcp/
 Project-URL: docs, https://awslabs.github.io/mcp/servers/valkey-mcp-server/
@@ -23,7 +23,7 @@ Classifier: Programming Language :: Python :: 3.13
 Requires-Python: >=3.10
 Requires-Dist: dotenv>=0.9.9
 Requires-Dist: loguru>=0.7.0
-Requires-Dist: mcp[cli]>=1.6.0
+Requires-Dist: mcp[cli]>=1.11.0
 Requires-Dist: numpy>=2.2.4
 Requires-Dist: pydantic>=2.10.6
 Requires-Dist: valkey>=6.1.0
@@ -50,6 +50,7 @@ This MCP server provides tools to operate on Valkey data types. For example, it
 - **Cluster Support**: Support for standalone and clustered Valkey deployments.
 - **SSL/TLS Security**: Configure secure connections using SSL/TLS.
 - **Connection Pooling**: Pools connections by default to enable efficient connection management.
+- **Readonly Mode**: Prevent write operations to ensure data safety.
 
 ## Prerequisites
 
@@ -61,6 +62,10 @@ This MCP server provides tools to operate on Valkey data types. For example, it
 
 ## Installation
 
+| Cursor | VS Code |
+|:------:|:-------:|
+| [![Install MCP Server](https://cursor.com/deeplink/mcp-install-light.svg)](https://cursor.com/install-mcp?name=awslabs.valkey-mcp-server&config=eyJjb21tYW5kIjoidXZ4IGF3c2xhYnMudmFsa2V5LW1jcC1zZXJ2ZXJAbGF0ZXN0IiwiZW52Ijp7IlZBTEtFWV9IT1NUIjoiMTI3LjAuMC4xIiwiVkFMS0VZX1BPUlQiOiI2Mzc5IiwiRkFTVE1DUF9MT0dfTEVWRUwiOiJFUlJPUiJ9LCJhdXRvQXBwcm92ZSI6W10sImRpc2FibGVkIjpmYWxzZX0%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=Valkey%20MCP%20Server&config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22awslabs.valkey-mcp-server%40latest%22%5D%2C%22env%22%3A%7B%22VALKEY_HOST%22%3A%22127.0.0.1%22%2C%22VALKEY_PORT%22%3A%226379%22%2C%22FASTMCP_LOG_LEVEL%22%3A%22ERROR%22%7D%2C%22autoApprove%22%3A%5B%5D%2C%22disabled%22%3Afalse%7D) |
+
 Here are some ways you can work with MCP across AWS tools (e.g., for Amazon Q Developer CLI MCP, `~/.aws/amazonq/mcp.json`):
 
 ```json
@@ -83,6 +88,29 @@ Here are some ways you can work with MCP across AWS tools (e.g., for Amazon Q De
 }
 ```
 
+To run in readonly mode:
+
+```json
+{
+  "mcpServers": {
+    "awslabs.valkey-mcp-server": {
+      "command": "uvx",
+      "args": [
+        "awslabs.valkey-mcp-server@latest",
+        "--readonly"
+      ],
+      "env": {
+        "VALKEY_HOST": "127.0.0.1",
+        "VALKEY_PORT": "6379",
+        "FASTMCP_LOG_LEVEL": "ERROR"
+      },
+      "autoApprove": [],
+      "disabled": false
+    }
+  }
+}
+```
+
 Or using Docker after a successful `docker build -t awslabs/valkey-mcp-server .`:
 
 ```json
@@ -110,6 +138,34 @@ Or using Docker after a successful `docker build -t awslabs/valkey-mcp-server .`
 }
 ```
 
+To run in readonly mode with Docker:
+
+```json
+{
+  "mcpServers": {
+    "awslabs.valkey-mcp-server": {
+      "command": "docker",
+      "args": [
+        "run",
+        "--rm",
+        "--interactive",
+        "--env",
+        "FASTMCP_LOG_LEVEL=ERROR",
+        "--env",
+        "VALKEY_HOST=127.0.0.1",
+        "--env",
+        "VALKEY_PORT=6379",
+        "awslabs/valkey-mcp-server:latest",
+        "--readonly"
+      ],
+      "env": {},
+      "disabled": false,
+      "autoApprove": []
+    }
+  }
+}
+```
+
 ## Configuration
 
 The server can be configured using the following environment variables:
@@ -163,3 +219,11 @@ docker run -p 8080:8080 \
   -e VALKEY_PORT=6379 \
   awslabs/valkey-mcp-server
 ```
+
+To run in readonly mode:
+```bash
+docker run -p 8080:8080 \
+  -e VALKEY_HOST=host.docker.internal \
+  -e VALKEY_PORT=6379 \
+  awslabs/valkey-mcp-server --readonly
+```

{awslabs_valkey_mcp_server-1.0.2 → awslabs_valkey_mcp_server-1.0.4}/README.md

@@ -19,6 +19,7 @@ This MCP server provides tools to operate on Valkey data types. For example, it
 - **Cluster Support**: Support for standalone and clustered Valkey deployments.
 - **SSL/TLS Security**: Configure secure connections using SSL/TLS.
 - **Connection Pooling**: Pools connections by default to enable efficient connection management.
+- **Readonly Mode**: Prevent write operations to ensure data safety.
 
 ## Prerequisites
 
@@ -30,6 +31,10 @@ This MCP server provides tools to operate on Valkey data types. For example, it
 
 ## Installation
 
+| Cursor | VS Code |
+|:------:|:-------:|
+| [![Install MCP Server](https://cursor.com/deeplink/mcp-install-light.svg)](https://cursor.com/install-mcp?name=awslabs.valkey-mcp-server&config=eyJjb21tYW5kIjoidXZ4IGF3c2xhYnMudmFsa2V5LW1jcC1zZXJ2ZXJAbGF0ZXN0IiwiZW52Ijp7IlZBTEtFWV9IT1NUIjoiMTI3LjAuMC4xIiwiVkFMS0VZX1BPUlQiOiI2Mzc5IiwiRkFTVE1DUF9MT0dfTEVWRUwiOiJFUlJPUiJ9LCJhdXRvQXBwcm92ZSI6W10sImRpc2FibGVkIjpmYWxzZX0%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=Valkey%20MCP%20Server&config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22awslabs.valkey-mcp-server%40latest%22%5D%2C%22env%22%3A%7B%22VALKEY_HOST%22%3A%22127.0.0.1%22%2C%22VALKEY_PORT%22%3A%226379%22%2C%22FASTMCP_LOG_LEVEL%22%3A%22ERROR%22%7D%2C%22autoApprove%22%3A%5B%5D%2C%22disabled%22%3Afalse%7D) |
+
 Here are some ways you can work with MCP across AWS tools (e.g., for Amazon Q Developer CLI MCP, `~/.aws/amazonq/mcp.json`):
 
 ```json
@@ -52,6 +57,29 @@ Here are some ways you can work with MCP across AWS tools (e.g., for Amazon Q De
 }
 ```
 
+To run in readonly mode:
+
+```json
+{
+  "mcpServers": {
+    "awslabs.valkey-mcp-server": {
+      "command": "uvx",
+      "args": [
+        "awslabs.valkey-mcp-server@latest",
+        "--readonly"
+      ],
+      "env": {
+        "VALKEY_HOST": "127.0.0.1",
+        "VALKEY_PORT": "6379",
+        "FASTMCP_LOG_LEVEL": "ERROR"
+      },
+      "autoApprove": [],
+      "disabled": false
+    }
+  }
+}
+```
+
 Or using Docker after a successful `docker build -t awslabs/valkey-mcp-server .`:
 
 ```json
@@ -79,6 +107,34 @@ Or using Docker after a successful `docker build -t awslabs/valkey-mcp-server .`
 }
 ```
 
+To run in readonly mode with Docker:
+
+```json
+{
+  "mcpServers": {
+    "awslabs.valkey-mcp-server": {
+      "command": "docker",
+      "args": [
+        "run",
+        "--rm",
+        "--interactive",
+        "--env",
+        "FASTMCP_LOG_LEVEL=ERROR",
+        "--env",
+        "VALKEY_HOST=127.0.0.1",
+        "--env",
+        "VALKEY_PORT=6379",
+        "awslabs/valkey-mcp-server:latest",
+        "--readonly"
+      ],
+      "env": {},
+      "disabled": false,
+      "autoApprove": []
+    }
+  }
+}
+```
+
 ## Configuration
 
 The server can be configured using the following environment variables:
@@ -132,3 +188,11 @@ docker run -p 8080:8080 \
   -e VALKEY_PORT=6379 \
   awslabs/valkey-mcp-server
 ```
+
+To run in readonly mode:
+```bash
+docker run -p 8080:8080 \
+  -e VALKEY_HOST=host.docker.internal \
+  -e VALKEY_PORT=6379 \
+  awslabs/valkey-mcp-server --readonly
+```

awslabs_valkey_mcp_server-1.0.2/docker-healthcheck.sh → awslabs_valkey_mcp_server-1.0.4/awslabs/valkey_mcp_server/context.py

@@ -1,5 +1,3 @@
-#!/bin/bash
-
 # Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
@@ -14,17 +12,28 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-# Check if the process is running
-if ! pgrep -f "awslabs.valkey-mcp-server" > /dev/null; then
-    echo "Process not running"
-    exit 1
-fi
+"""Context management for Valkey MCP Server."""
+
+
+class Context:
+    """Context class for Valkey MCP Server."""
+
+    _readonly = False
+
+    @classmethod
+    def initialize(cls, readonly: bool = False):
+        """Initialize the context.
+
+        Args:
+            readonly: Whether to run in readonly mode
+        """
+        cls._readonly = readonly
 
-# Check if the port is listening (default MCP server port is 8080)
-if ! lsof -i :8080 -sTCP:LISTEN > /dev/null; then
-    echo "Port 8080 not listening"
-    exit 1
-fi
+    @classmethod
+    def readonly_mode(cls) -> bool:
+        """Check if the server is running in readonly mode.
 
-# All checks passed
-exit 0
+        Returns:
+            True if readonly mode is enabled, False otherwise
+        """
+        return cls._readonly

{awslabs_valkey_mcp_server-1.0.2 → awslabs_valkey_mcp_server-1.0.4}/awslabs/valkey_mcp_server/main.py

@@ -14,7 +14,9 @@
 
 """awslabs valkey MCP Server implementation."""
 
+import argparse
 from awslabs.valkey_mcp_server.common.server import mcp
+from awslabs.valkey_mcp_server.context import Context
 from awslabs.valkey_mcp_server.tools import (
     bitmap,  # noqa: F401
     hash,  # noqa: F401
@@ -56,6 +58,18 @@ class ValkeyMCPServer:
 
 def main():
     """Run the MCP server with CLI argument support."""
+    parser = argparse.ArgumentParser(
+        description='An AWS Labs Model Context Protocol (MCP) server for interacting with Valkey'
+    )
+    parser.add_argument(
+        '--readonly',
+        action=argparse.BooleanOptionalAction,
+        help='Prevents the MCP server from performing mutating operations',
+    )
+
+    args = parser.parse_args()
+    Context.initialize(args.readonly)
+
     logger.info('Amazon ElastiCache/MemoryDB Valkey MCP Server Started...')
 
     server = ValkeyMCPServer()

{awslabs_valkey_mcp_server-1.0.2 → awslabs_valkey_mcp_server-1.0.4}/awslabs/valkey_mcp_server/tools/bitmap.py

@@ -16,6 +16,7 @@
 
 from awslabs.valkey_mcp_server.common.connection import ValkeyConnectionManager
 from awslabs.valkey_mcp_server.common.server import mcp
+from awslabs.valkey_mcp_server.context import Context
 from typing import Optional
 from valkey.exceptions import ValkeyError
 
@@ -32,6 +33,10 @@ async def bitmap_set(key: str, offset: int, value: int) -> str:
     Returns:
         Success message or error message
     """
+    # Check if readonly mode is enabled
+    if Context.readonly_mode():
+        return 'Error: Cannot set bitmap bit in readonly mode'
+
     try:
         if value not in (0, 1):
             return f'Error: value must be 0 or 1, got {value}'

{awslabs_valkey_mcp_server-1.0.2 → awslabs_valkey_mcp_server-1.0.4}/awslabs/valkey_mcp_server/tools/hash.py

@@ -16,6 +16,7 @@
 
 from awslabs.valkey_mcp_server.common.connection import ValkeyConnectionManager
 from awslabs.valkey_mcp_server.common.server import mcp
+from awslabs.valkey_mcp_server.context import Context
 from typing import Any, Dict, Optional, Union
 from valkey.exceptions import ValkeyError
 
@@ -32,6 +33,10 @@ async def hash_set(key: str, field: str, value: Any) -> str:
     Returns:
         Success message or error message
     """
+    # Check if readonly mode is enabled
+    if Context.readonly_mode():
+        return 'Error: Cannot set hash field in readonly mode'
+
     try:
         r = ValkeyConnectionManager.get_connection()
         r.hset(key, field, value)
@@ -51,6 +56,10 @@ async def hash_set_multiple(key: str, mapping: Dict[str, Any]) -> str:
     Returns:
         Success message or error message
     """
+    # Check if readonly mode is enabled
+    if Context.readonly_mode():
+        return 'Error: Cannot set multiple hash fields in readonly mode'
+
     try:
         r = ValkeyConnectionManager.get_connection()
         result = r.hset(key, mapping=mapping)
@@ -71,6 +80,10 @@ async def hash_set_if_not_exists(key: str, field: str, value: Any) -> str:
     Returns:
         Success message or error message
     """
+    # Check if readonly mode is enabled
+    if Context.readonly_mode():
+        return 'Error: Cannot set hash field in readonly mode'
+
     try:
         r = ValkeyConnectionManager.get_connection()
         result = r.hsetnx(key, field, value)
@@ -153,6 +166,10 @@ async def hash_increment(key: str, field: str, amount: Union[int, float] = 1) ->
     Returns:
         New value or error message
     """
+    # Check if readonly mode is enabled
+    if Context.readonly_mode():
+        return 'Error: Cannot increment hash field in readonly mode'
+
     try:
         r = ValkeyConnectionManager.get_connection()
         if isinstance(amount, int):

{awslabs_valkey_mcp_server-1.0.2 → awslabs_valkey_mcp_server-1.0.4}/awslabs/valkey_mcp_server/tools/hyperloglog.py

@@ -16,6 +16,7 @@
 
 from awslabs.valkey_mcp_server.common.connection import ValkeyConnectionManager
 from awslabs.valkey_mcp_server.common.server import mcp
+from awslabs.valkey_mcp_server.context import Context
 from valkey.exceptions import ValkeyError
 
 
@@ -30,6 +31,10 @@ async def hll_add(key: str, element: str) -> str:
     Returns:
         Success message or error message
     """
+    # Check if readonly mode is enabled
+    if Context.readonly_mode():
+        return 'Error: Cannot add to HyperLogLog in readonly mode'
+
     try:
         if not element:
             return 'Error: an element is required'

{awslabs_valkey_mcp_server-1.0.2 → awslabs_valkey_mcp_server-1.0.4}/awslabs/valkey_mcp_server/tools/json.py

@@ -16,6 +16,7 @@
 
 from awslabs.valkey_mcp_server.common.connection import ValkeyConnectionManager
 from awslabs.valkey_mcp_server.common.server import mcp
+from awslabs.valkey_mcp_server.context import Context
 from typing import Any, Optional, Union
 from valkey.exceptions import ValkeyError
 
@@ -34,15 +35,13 @@ async def json_set(key: str, path: str, value: Any, nx: bool = False, xx: bool =
     Returns:
         Success message or error message
     """
+    # Check if readonly mode is enabled
+    if Context.readonly_mode():
+        return 'Error: Cannot set JSON value in readonly mode'
+
     try:
         r = ValkeyConnectionManager.get_connection()
-        options = {}
-        if nx:
-            options['nx'] = True
-        if xx:
-            options['xx'] = True
-
-        result = r.json().set(key, path, value, **options)
+        result = r.json().set(key, path, value, nx=nx, xx=xx)
         if result:
             return f"Successfully set value at path '{path}' in '{key}'"
         return f"Failed to set value at path '{path}' in '{key}' (path condition not met)"
@@ -121,6 +120,10 @@ async def json_numincrby(key: str, path: str, value: Union[int, float]) -> str:
     Returns:
         New value or error message
     """
+    # Check if readonly mode is enabled
+    if Context.readonly_mode():
+        return 'Error: Cannot increment JSON value in readonly mode'
+
     try:
         r = ValkeyConnectionManager.get_connection()
         # Convert float to int by rounding if needed
@@ -143,6 +146,10 @@ async def json_nummultby(key: str, path: str, value: Union[int, float]) -> str:
     Returns:
         New value or error message
     """
+    # Check if readonly mode is enabled
+    if Context.readonly_mode():
+        return 'Error: Cannot multiply JSON value in readonly mode'
+
     try:
         r = ValkeyConnectionManager.get_connection()
         # Convert float to int by rounding if needed
@@ -165,6 +172,10 @@ async def json_strappend(key: str, path: str, value: str) -> str:
     Returns:
         New string length or error message
     """
+    # Check if readonly mode is enabled
+    if Context.readonly_mode():
+        return 'Error: Cannot append to JSON string in readonly mode'
+
     try:
         r = ValkeyConnectionManager.get_connection()
         result = r.json().strappend(key, path, value)
@@ -206,6 +217,10 @@ async def json_arrappend(key: str, path: str, *values: Any) -> str:
     Returns:
         New array length or error message
     """
+    # Check if readonly mode is enabled
+    if Context.readonly_mode():
+        return 'Error: Cannot append to JSON array in readonly mode'
+
     try:
         if not values:
             return 'Error: at least one value is required'
@@ -285,6 +300,10 @@ async def json_arrpop(key: str, path: str, index: int = -1) -> str:
     Returns:
         Popped value or error message
     """
+    # Check if readonly mode is enabled
+    if Context.readonly_mode():
+        return 'Error: Cannot pop from JSON array in readonly mode'
+
     try:
         r = ValkeyConnectionManager.get_connection()
         result = r.json().arrpop(key, path, index)
@@ -308,6 +327,10 @@ async def json_arrtrim(key: str, path: str, start: int, stop: int) -> str:
     Returns:
         New array length or error message
     """
+    # Check if readonly mode is enabled
+    if Context.readonly_mode():
+        return 'Error: Cannot trim JSON array in readonly mode'
+
     try:
         r = ValkeyConnectionManager.get_connection()
         result = r.json().arrtrim(key, path, start, stop)
@@ -373,6 +396,10 @@ async def json_toggle(key: str, path: str) -> str:
     Returns:
         New boolean value or error message
     """
+    # Check if readonly mode is enabled
+    if Context.readonly_mode():
+        return 'Error: Cannot toggle JSON boolean in readonly mode'
+
     try:
         r = ValkeyConnectionManager.get_connection()
         result = r.json().toggle(key, path)
@@ -394,6 +421,10 @@ async def json_clear(key: str, path: str) -> str:
     Returns:
         Success message or error message
     """
+    # Check if readonly mode is enabled
+    if Context.readonly_mode():
+        return 'Error: Cannot clear JSON container in readonly mode'
+
     try:
         r = ValkeyConnectionManager.get_connection()
         result = r.json().clear(key, path)
@@ -415,6 +446,10 @@ async def json_del(key: str, path: str) -> str:
     Returns:
         Success message or error message
     """
+    # Check if readonly mode is enabled
+    if Context.readonly_mode():
+        return 'Error: Cannot delete JSON value in readonly mode'
+
     try:
         r = ValkeyConnectionManager.get_connection()
         result = r.json().delete(key, path)