awslabs.memcached-mcp-server 1.0.1__py3-none-any.whl → 1.0.3__py3-none-any.whl

awslabs/memcached_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 Memcached MCP Server."""
+
+
+class Context:
+    """Context class for Memcached 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/memcached_mcp_server/main.py

@@ -14,7 +14,9 @@
 
 """awslabs memcached MCP Server implementation."""
 
+import argparse
 from awslabs.memcached_mcp_server.common.server import mcp
+from awslabs.memcached_mcp_server.context import Context
 from awslabs.memcached_mcp_server.tools import cache  # noqa: F401
 from loguru import logger
 from starlette.requests import Request  # noqa: F401
@@ -41,6 +43,18 @@ class MemcachedMCPServer:
 
 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 Memcached'
+    )
+    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 Memcached MCP Server Started...')
     MemcachedMCPServer().run()
 

awslabs/memcached_mcp_server/tools/cache.py

@@ -16,6 +16,7 @@
 
 from awslabs.memcached_mcp_server.common.connection import MemcachedConnectionManager
 from awslabs.memcached_mcp_server.common.server import mcp
+from awslabs.memcached_mcp_server.context import Context
 from pymemcache.exceptions import MemcacheError
 from typing import Any, Dict, List, Optional
 
@@ -106,6 +107,9 @@ async def cache_set(key: str, value: Any, expire: Optional[int] = None) -> str:
     Returns:
         Success message or error message
     """
+    if Context.readonly_mode():
+        return 'Operation not permitted: Server is in readonly mode'
+
     try:
         client = MemcachedConnectionManager.get_connection()
         client.set(key, value, expire=expire)
@@ -128,6 +132,9 @@ async def cache_cas(key: str, value: Any, cas: int, expire: Optional[int] = None
     Returns:
         Success message or error message
     """
+    if Context.readonly_mode():
+        return 'Operation not permitted: Server is in readonly mode'
+
     try:
         client = MemcachedConnectionManager.get_connection()
         if client.cas(key, value, cas, expire=expire):
@@ -149,6 +156,9 @@ async def cache_set_many(mapping: Dict[str, Any], expire: Optional[int] = None)
     Returns:
         Success message or error message
     """
+    if Context.readonly_mode():
+        return 'Operation not permitted: Server is in readonly mode'
+
     try:
         client = MemcachedConnectionManager.get_connection()
         failed = client.set_many(mapping, expire=expire)
@@ -186,6 +196,9 @@ async def cache_add(key: str, value: Any, expire: Optional[int] = None) -> str:
     Returns:
         Success message or error message
     """
+    if Context.readonly_mode():
+        return 'Operation not permitted: Server is in readonly mode'
+
     try:
         client = MemcachedConnectionManager.get_connection()
         if client.add(key, value, expire=expire):
@@ -208,6 +221,9 @@ async def cache_replace(key: str, value: Any, expire: Optional[int] = None) -> s
     Returns:
         Success message or error message
     """
+    if Context.readonly_mode():
+        return 'Operation not permitted: Server is in readonly mode'
+
     try:
         client = MemcachedConnectionManager.get_connection()
         if client.replace(key, value, expire=expire):
@@ -229,6 +245,9 @@ async def cache_append(key: str, value: str) -> str:
     Returns:
         Success message or error message
     """
+    if Context.readonly_mode():
+        return 'Operation not permitted: Server is in readonly mode'
+
     try:
         client = MemcachedConnectionManager.get_connection()
         if client.append(key, value):
@@ -249,6 +268,9 @@ async def cache_prepend(key: str, value: str) -> str:
     Returns:
         Success message or error message
     """
+    if Context.readonly_mode():
+        return 'Operation not permitted: Server is in readonly mode'
+
     try:
         client = MemcachedConnectionManager.get_connection()
         if client.prepend(key, value):
@@ -268,6 +290,9 @@ async def cache_delete(key: str) -> str:
     Returns:
         Success message or error message
     """
+    if Context.readonly_mode():
+        return 'Operation not permitted: Server is in readonly mode'
+
     try:
         client = MemcachedConnectionManager.get_connection()
         if client.delete(key):
@@ -287,6 +312,9 @@ async def cache_delete_many(keys: List[str]) -> str:
     Returns:
         Success message or error message
     """
+    if Context.readonly_mode():
+        return 'Operation not permitted: Server is in readonly mode'
+
     try:
         client = MemcachedConnectionManager.get_connection()
         failed = client.delete_many(keys)
@@ -321,6 +349,9 @@ async def cache_incr(key: str, value: int = 1) -> str:
     Returns:
         New value or error message
     """
+    if Context.readonly_mode():
+        return 'Operation not permitted: Server is in readonly mode'
+
     try:
         client = MemcachedConnectionManager.get_connection()
         result = client.incr(key, value)
@@ -342,6 +373,9 @@ async def cache_decr(key: str, value: int = 1) -> str:
     Returns:
         New value or error message
     """
+    if Context.readonly_mode():
+        return 'Operation not permitted: Server is in readonly mode'
+
     try:
         client = MemcachedConnectionManager.get_connection()
         result = client.decr(key, value)
@@ -363,6 +397,9 @@ async def cache_touch(key: str, expire: int) -> str:
     Returns:
         Success message or error message
     """
+    if Context.readonly_mode():
+        return 'Operation not permitted: Server is in readonly mode'
+
     try:
         client = MemcachedConnectionManager.get_connection()
         if client.touch(key, expire):
@@ -400,6 +437,9 @@ async def cache_flush_all(delay: int = 0) -> str:
     Returns:
         Success message or error message
     """
+    if Context.readonly_mode():
+        return 'Operation not permitted: Server is in readonly mode'
+
     try:
         client = MemcachedConnectionManager.get_connection()
         client.flush_all(delay=delay)

{awslabs_memcached_mcp_server-1.0.1.dist-info → awslabs_memcached_mcp_server-1.0.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: awslabs.memcached-mcp-server
-Version: 1.0.1
+Version: 1.0.3
 Summary: An AWS Labs Model Context Protocol (MCP) server for Amazon ElastiCache Memcached
 Project-URL: homepage, https://awslabs.github.io/mcp/
 Project-URL: docs, https://awslabs.github.io/mcp/servers/memcached-mcp-server/
@@ -40,6 +40,17 @@ MCP server for interacting with Amazon ElastiCache Memcached through a secure an
 - Secure communication with SSL/TLS encryption
 - Automatic connection management and pooling
 - Built-in retry mechanism for failed operations
+- Readonly mode to prevent write operations
+
+### Readonly Mode
+
+The server can be started in readonly mode, which prevents any write operations from being performed. This is useful for scenarios where you want to ensure that no data is modified, such as:
+
+- Read-only replicas
+- Production environments where writes should be restricted
+- Debugging and monitoring without risk of data modification
+
+When readonly mode is enabled, any attempt to perform a write operation (set, add, replace, delete, etc.) will return an error message.
 
 ## Prerequisites
 
@@ -51,6 +62,8 @@ MCP server for interacting with Amazon ElastiCache Memcached through a secure an
 
 ## Installation
 
+[![Install MCP Server](https://cursor.com/deeplink/mcp-install-light.svg)](https://cursor.com/install-mcp?name=awslabs.memcached-mcp-server&config=eyJjb21tYW5kIjoidXZ4IGF3c2xhYnMubWVtY2FjaGVkLW1jcC1zZXJ2ZXJAbGF0ZXN0IiwiZW52Ijp7IkZBU1RNQ1BfTE9HX0xFVkVMIjoiRVJST1IiLCJNRU1DQUNIRURfSE9TVCI6InlvdXItbWVtY2FjaGVkLWhvc3QiLCJNRU1DQUNIRURfUE9SVCI6IjExMjExIn0sImRpc2FibGVkIjpmYWxzZSwiYXV0b0FwcHJvdmUiOltdfQ%3D%3D)
+
 Here are some ways you can work with MCP (e.g. for Amazon Q Developer CLI MCP, `~/.aws/amazonq/mcp.json`):
 
 ```json
@@ -71,6 +84,26 @@ Here are some ways you can work with MCP (e.g. for Amazon Q Developer CLI MCP, `
 }
 ```
 
+To run in readonly mode:
+
+```json
+{
+  "mcpServers": {
+    "awslabs.memcached-mcp-server": {
+      "command": "uvx",
+      "args": ["awslabs.memcached-mcp-server@latest", "--readonly"],
+      "env": {
+        "FASTMCP_LOG_LEVEL": "ERROR",
+        "MEMCACHED_HOST": "your-memcached-host",
+        "MEMCACHED_PORT": "11211"
+      },
+      "disabled": false,
+      "autoApprove": []
+    }
+  }
+}
+```
+
 or docker after a successful `docker build -t awslabs/memcached-mcp-server .`:
 
 ```json
@@ -98,6 +131,34 @@ or docker after a successful `docker build -t awslabs/memcached-mcp-server .`:
 }
 ```
 
+To run in readonly mode with Docker:
+
+```json
+{
+  "mcpServers": {
+    "awslabs.memcached-mcp-server": {
+      "command": "docker",
+      "args": [
+        "run",
+        "--rm",
+        "--interactive",
+        "--env",
+        "FASTMCP_LOG_LEVEL=ERROR",
+        "--env",
+        "MEMCACHED_HOST=your-memcached-host",
+        "--env",
+        "MEMCACHED_PORT=11211",
+        "awslabs/memcached-mcp-server:latest",
+        "--readonly"
+      ],
+      "env": {},
+      "disabled": false,
+      "autoApprove": []
+    }
+  }
+}
+```
+
 ## Configuration
 
 ### Basic Connection Settings
@@ -155,3 +216,11 @@ docker run -p 8080:8080 \
   -e MEMCACHED_PORT=11211 \
   awslabs/memcached-mcp-server
 ```
+
+To run in readonly mode:
+```bash
+docker run -p 8080:8080 \
+  -e MEMCACHED_HOST=host.docker.internal \
+  -e MEMCACHED_PORT=11211 \
+  awslabs/memcached-mcp-server --readonly
+```

awslabs_memcached_mcp_server-1.0.3.dist-info/RECORD

@@ -0,0 +1,14 @@
+awslabs/__init__.py,sha256=WuqxdDgUZylWNmVoPKiK7qGsTB_G4UmuXIrJ-VBwDew,731
+awslabs/memcached_mcp_server/__init__.py,sha256=kjzUc4HQwca7XN0Fcui7P6fTGfdvcO8BeJEmIOpy3HU,674
+awslabs/memcached_mcp_server/context.py,sha256=pKBy_KHw8yRp-KLONViPZ1jMQpwyFt-Q-HqEVIngDV0,1208
+awslabs/memcached_mcp_server/main.py,sha256=Bi9Nsox0KzJoyGDjt7gLBso4Sfb6QJXIhsm92I5UN3o,2094
+awslabs/memcached_mcp_server/common/config.py,sha256=XnTCcE1Gddbfhy2qy3TvHxIMzk-NR9B2Yg7RIwephvA,765
+awslabs/memcached_mcp_server/common/connection.py,sha256=4-IiFOrjRGs-ywjmPwgcRE-WbIQ5ySuHxjfuQvpaH2A,3704
+awslabs/memcached_mcp_server/common/server.py,sha256=vAJ0vRb_pxiIRl9CtOb1OheLJOCETLbxykij1a2rDAw,1205
+awslabs/memcached_mcp_server/tools/cache.py,sha256=wryYq0yvrXTe8qRPF5Tm_h-gAFHt-3ZNg04mwAibBIk,14154
+awslabs_memcached_mcp_server-1.0.3.dist-info/METADATA,sha256=ZBSVWYhzBkFTB9urCjEKGCaDENwJS-q-dYXLYncbYgU,6822
+awslabs_memcached_mcp_server-1.0.3.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+awslabs_memcached_mcp_server-1.0.3.dist-info/entry_points.txt,sha256=L6eXQdXenEsLGoVjKoZCyrrEMfDfXrSqGn_i-jYmES8,88
+awslabs_memcached_mcp_server-1.0.3.dist-info/licenses/LICENSE,sha256=CeipvOyAZxBGUsFoaFqwkx54aPnIKEtm9a5u2uXxEws,10142
+awslabs_memcached_mcp_server-1.0.3.dist-info/licenses/NOTICE,sha256=Wxt-EHT4RdVQIf79fYjNk-uwPDYiRwXxH_QNfGIG5Lg,96
+awslabs_memcached_mcp_server-1.0.3.dist-info/RECORD,,

awslabs_memcached_mcp_server-1.0.1.dist-info/RECORD

@@ -1,13 +0,0 @@
-awslabs/__init__.py,sha256=WuqxdDgUZylWNmVoPKiK7qGsTB_G4UmuXIrJ-VBwDew,731
-awslabs/memcached_mcp_server/__init__.py,sha256=kjzUc4HQwca7XN0Fcui7P6fTGfdvcO8BeJEmIOpy3HU,674
-awslabs/memcached_mcp_server/main.py,sha256=n3jgCPSw5npBWkqKmK4cd2uDgkucFBRZmkoZhKkwbco,1629
-awslabs/memcached_mcp_server/common/config.py,sha256=XnTCcE1Gddbfhy2qy3TvHxIMzk-NR9B2Yg7RIwephvA,765
-awslabs/memcached_mcp_server/common/connection.py,sha256=4-IiFOrjRGs-ywjmPwgcRE-WbIQ5ySuHxjfuQvpaH2A,3704
-awslabs/memcached_mcp_server/common/server.py,sha256=vAJ0vRb_pxiIRl9CtOb1OheLJOCETLbxykij1a2rDAw,1205
-awslabs/memcached_mcp_server/tools/cache.py,sha256=mdyA-tZ0uLN39gg_Jy7KZgn_ouZWmKGQUkRxkhUD-FE,12771
-awslabs_memcached_mcp_server-1.0.1.dist-info/METADATA,sha256=3syyFu-HMNuKqt3JSLHmopvzCmAMlgm_5ruWEfoCHvw,4781
-awslabs_memcached_mcp_server-1.0.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-awslabs_memcached_mcp_server-1.0.1.dist-info/entry_points.txt,sha256=L6eXQdXenEsLGoVjKoZCyrrEMfDfXrSqGn_i-jYmES8,88
-awslabs_memcached_mcp_server-1.0.1.dist-info/licenses/LICENSE,sha256=CeipvOyAZxBGUsFoaFqwkx54aPnIKEtm9a5u2uXxEws,10142
-awslabs_memcached_mcp_server-1.0.1.dist-info/licenses/NOTICE,sha256=Wxt-EHT4RdVQIf79fYjNk-uwPDYiRwXxH_QNfGIG5Lg,96
-awslabs_memcached_mcp_server-1.0.1.dist-info/RECORD,,