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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: awslabs.valkey-mcp-server
-Version: 1.0.2
+Version: 1.0.3
 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/
@@ -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,8 @@ This MCP server provides tools to operate on Valkey data types. For example, it
 
 ## Installation
 
+[![Install MCP Server](https://cursor.com/deeplink/mcp-install-light.svg)](https://cursor.com/install-mcp?name=awslabs.valkey-mcp-server&config=eyJjb21tYW5kIjoidXZ4IGF3c2xhYnMudmFsa2V5LW1jcC1zZXJ2ZXJAbGF0ZXN0IiwiZW52Ijp7IlZBTEtFWV9IT1NUIjoiMTI3LjAuMC4xIiwiVkFMS0VZX1BPUlQiOiI2Mzc5IiwiRkFTVE1DUF9MT0dfTEVWRUwiOiJFUlJPUiJ9LCJhdXRvQXBwcm92ZSI6W10sImRpc2FibGVkIjpmYWxzZX0%3D)
+
 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 +86,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 +136,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 +217,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.3}/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,8 @@ This MCP server provides tools to operate on Valkey data types. For example, it
 
 ## Installation
 
+[![Install MCP Server](https://cursor.com/deeplink/mcp-install-light.svg)](https://cursor.com/install-mcp?name=awslabs.valkey-mcp-server&config=eyJjb21tYW5kIjoidXZ4IGF3c2xhYnMudmFsa2V5LW1jcC1zZXJ2ZXJAbGF0ZXN0IiwiZW52Ijp7IlZBTEtFWV9IT1NUIjoiMTI3LjAuMC4xIiwiVkFMS0VZX1BPUlQiOiI2Mzc5IiwiRkFTVE1DUF9MT0dfTEVWRUwiOiJFUlJPUiJ9LCJhdXRvQXBwcm92ZSI6W10sImRpc2FibGVkIjpmYWxzZX0%3D)
+
 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 +55,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 +105,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 +186,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.3/awslabs/valkey_mcp_server/context.py

@@ -0,0 +1,39 @@
+# 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.
+
+"""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
+
+    @classmethod
+    def readonly_mode(cls) -> bool:
+        """Check if the server is running in readonly mode.
+
+        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.3}/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.3}/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.3}/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.3}/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.3}/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)

{awslabs_valkey_mcp_server-1.0.2 → awslabs_valkey_mcp_server-1.0.3}/awslabs/valkey_mcp_server/tools/list.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
 from typing import List as PyList
 from valkey.exceptions import ValkeyError
@@ -32,6 +33,10 @@ async def list_append(key: str, value: Any) -> str:
     Returns:
         Success message or error message
     """
+    # Check if readonly mode is enabled
+    if Context.readonly_mode():
+        return 'Error: Cannot append to list in readonly mode'
+
     try:
         r = ValkeyConnectionManager.get_connection()
         result = r.rpush(key, value)
@@ -51,6 +56,10 @@ async def list_prepend(key: str, value: Any) -> str:
     Returns:
         Success message or error message
     """
+    # Check if readonly mode is enabled
+    if Context.readonly_mode():
+        return 'Error: Cannot prepend to list in readonly mode'
+
     try:
         r = ValkeyConnectionManager.get_connection()
         result = r.lpush(key, value)
@@ -70,6 +79,10 @@ async def list_append_multiple(key: str, values: PyList[Any]) -> str:
     Returns:
         Success message or error message
     """
+    # Check if readonly mode is enabled
+    if Context.readonly_mode():
+        return 'Error: Cannot append to list in readonly mode'
+
     try:
         r = ValkeyConnectionManager.get_connection()
         result = r.rpush(key, *values)
@@ -89,6 +102,10 @@ async def list_prepend_multiple(key: str, values: PyList[Any]) -> str:
     Returns:
         Success message or error message
     """
+    # Check if readonly mode is enabled
+    if Context.readonly_mode():
+        return 'Error: Cannot prepend to list in readonly mode'
+
     try:
         r = ValkeyConnectionManager.get_connection()
         result = r.lpush(key, *values)
@@ -130,6 +147,10 @@ async def list_set(key: str, index: int, value: Any) -> str:
     Returns:
         Success message or error message
     """
+    # Check if readonly mode is enabled
+    if Context.readonly_mode():
+        return 'Error: Cannot set list value in readonly mode'
+
     try:
         r = ValkeyConnectionManager.get_connection()
         r.lset(key, index, value)
@@ -172,6 +193,10 @@ async def list_trim(key: str, start: int, stop: int) -> str:
     Returns:
         Success message or error message
     """
+    # Check if readonly mode is enabled
+    if Context.readonly_mode():
+        return 'Error: Cannot trim list in readonly mode'
+
     try:
         r = ValkeyConnectionManager.get_connection()
         r.ltrim(key, start, stop)
@@ -209,6 +234,10 @@ async def list_pop_left(key: str, count: Optional[int] = None) -> str:
     Returns:
         Value(s) or error message
     """
+    # Check if readonly mode is enabled
+    if Context.readonly_mode():
+        return 'Error: Cannot pop from list in readonly mode'
+
     try:
         r = ValkeyConnectionManager.get_connection()
         if count:
@@ -233,6 +262,10 @@ async def list_pop_right(key: str, count: Optional[int] = None) -> str:
     Returns:
         Value(s) or error message
     """
+    # Check if readonly mode is enabled
+    if Context.readonly_mode():
+        return 'Error: Cannot pop from list in readonly mode'
+
     try:
         r = ValkeyConnectionManager.get_connection()
         if count:
@@ -299,6 +332,10 @@ async def list_move(
     Returns:
         Moved value or error message
     """
+    # Check if readonly mode is enabled
+    if Context.readonly_mode():
+        return 'Error: Cannot move list elements in readonly mode'
+
     try:
         r = ValkeyConnectionManager.get_connection()
         wherefrom = wherefrom.upper()
@@ -327,6 +364,10 @@ async def list_insert_before(key: str, pivot: Any, value: Any) -> str:
     Returns:
         Success message or error message
     """
+    # Check if readonly mode is enabled
+    if Context.readonly_mode():
+        return 'Error: Cannot insert into list in readonly mode'
+
     try:
         r = ValkeyConnectionManager.get_connection()
         result = r.linsert(key, 'BEFORE', pivot, value)
@@ -349,6 +390,10 @@ async def list_insert_after(key: str, pivot: Any, value: Any) -> str:
     Returns:
         Success message or error message
     """
+    # Check if readonly mode is enabled
+    if Context.readonly_mode():
+        return 'Error: Cannot insert into list in readonly mode'
+
     try:
         r = ValkeyConnectionManager.get_connection()
         result = r.linsert(key, 'AFTER', pivot, value)
@@ -371,6 +416,10 @@ async def list_remove(key: str, value: Any, count: int = 0) -> str:
     Returns:
         Success message or error message
     """
+    # Check if readonly mode is enabled
+    if Context.readonly_mode():
+        return 'Error: Cannot remove from list in readonly mode'
+
     try:
         r = ValkeyConnectionManager.get_connection()
         result = r.lrem(key, count, value)

{awslabs_valkey_mcp_server-1.0.2 → awslabs_valkey_mcp_server-1.0.3}/awslabs/valkey_mcp_server/tools/misc.py

@@ -14,6 +14,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
 from valkey.exceptions import ValkeyError as RedisError
 
@@ -28,6 +29,10 @@ async def delete(key: str) -> str:
     Returns:
         str: Confirmation message or an error message.
     """
+    # Check if readonly mode is enabled
+    if Context.readonly_mode():
+        return 'Error: Cannot delete key in readonly mode'
+
     try:
         r = ValkeyConnectionManager.get_connection()
         result = r.delete(key)
@@ -67,6 +72,10 @@ async def expire(name: str, expire_seconds: int) -> str:
     Returns:
         A success message or an error message.
     """
+    # Check if readonly mode is enabled
+    if Context.readonly_mode():
+        return 'Error: Cannot set expiration in readonly mode'
+
     try:
         r = ValkeyConnectionManager.get_connection()
         success = r.expire(name, expire_seconds)
@@ -92,6 +101,10 @@ async def rename(old_key: str, new_key: str) -> Dict[str, Any]:
             On success: {"status": "success", "message": "..."}
             On error: {"error": "..."}
     """
+    # Check if readonly mode is enabled
+    if Context.readonly_mode():
+        return {'error': 'Cannot rename key in readonly mode'}
+
     try:
         r = ValkeyConnectionManager.get_connection()