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

{awslabs_memcached_mcp_server-1.0.2 → awslabs_memcached_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
@@ -74,5 +84,5 @@ COPY ./docker-healthcheck.sh /usr/local/bin/docker-healthcheck.sh
 USER app
 
 # When running the container, add --db-path and a bind mount to the host's db file
-HEALTHCHECK --interval=30s --timeout=30s --start-period=5s --retries=3 CMD [ "docker-healthcheck.sh" ]
+HEALTHCHECK --interval=60s --timeout=10s --start-period=10s --retries=3 CMD ["docker-healthcheck.sh"]
 ENTRYPOINT ["awslabs.memcached-mcp-server"]

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: awslabs.memcached-mcp-server
-Version: 1.0.2
+Version: 1.0.4
 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/
@@ -22,7 +22,7 @@ Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Requires-Python: >=3.10
 Requires-Dist: loguru>=0.7.0
-Requires-Dist: mcp[cli]>=1.6.0
+Requires-Dist: mcp[cli]>=1.11.0
 Requires-Dist: pydantic>=2.10.6
 Requires-Dist: pymemcache>=4.0.0
 Requires-Dist: python-dotenv>=0.9.9
@@ -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,10 @@ MCP server for interacting with Amazon ElastiCache Memcached through a secure an
 
 ## Installation
 
+| Cursor | VS Code |
+|:------:|:-------:|
+| [![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) | [![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=Memcached%20MCP%20Server&config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22awslabs.memcached-mcp-server%40latest%22%5D%2C%22env%22%3A%7B%22FASTMCP_LOG_LEVEL%22%3A%22ERROR%22%2C%22MEMCACHED_HOST%22%3A%22your-memcached-host%22%2C%22MEMCACHED_PORT%22%3A%2211211%22%7D%2C%22disabled%22%3Afalse%2C%22autoApprove%22%3A%5B%5D%7D) |
+
 Here are some ways you can work with MCP (e.g. for Amazon Q Developer CLI MCP, `~/.aws/amazonq/mcp.json`):
 
 ```json
@@ -71,6 +86,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 +133,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 +218,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.2 → awslabs_memcached_mcp_server-1.0.4}/README.md

@@ -10,6 +10,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
 
@@ -21,6 +32,10 @@ MCP server for interacting with Amazon ElastiCache Memcached through a secure an
 
 ## Installation
 
+| Cursor | VS Code |
+|:------:|:-------:|
+| [![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) | [![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=Memcached%20MCP%20Server&config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22awslabs.memcached-mcp-server%40latest%22%5D%2C%22env%22%3A%7B%22FASTMCP_LOG_LEVEL%22%3A%22ERROR%22%2C%22MEMCACHED_HOST%22%3A%22your-memcached-host%22%2C%22MEMCACHED_PORT%22%3A%2211211%22%7D%2C%22disabled%22%3Afalse%2C%22autoApprove%22%3A%5B%5D%7D) |
+
 Here are some ways you can work with MCP (e.g. for Amazon Q Developer CLI MCP, `~/.aws/amazonq/mcp.json`):
 
 ```json
@@ -41,6 +56,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
@@ -68,6 +103,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
@@ -125,3 +188,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.4/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-1.0.2 → awslabs_memcached_mcp_server-1.0.4}/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-1.0.2 → awslabs_memcached_mcp_server-1.0.4}/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.2 → awslabs_memcached_mcp_server-1.0.4}/docker-healthcheck.sh

@@ -1,5 +1,4 @@
 #!/bin/sh
-
 # Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
@@ -14,13 +13,13 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-if [ "$(lsof +c 0 -p 1 | grep -e grep -e "^awslabs\..*\s1\s.*\unix\s.*socket$" | wc -l)" -ne "0" ]; then
-  echo -n "$(lsof +c 0 -p 1 | grep -e grep -e "^awslabs\..*\s1\s.*\unix\s.*socket$" | wc -l) awslabs.* streams found";
+SERVER="memcached-mcp-server"
+
+# Check if the server process is running
+if pgrep -P 0 -a -l -x -f "/app/.venv/bin/python3 /app/.venv/bin/awslabs.$SERVER" > /dev/null; then
+  echo -n "$SERVER is running";
   exit 0;
-else
-  echo -n "Zero awslabs.* streams found";
-  exit 1;
 fi;
 
-echo -n "Never should reach here";
-exit 99;
+# Unhealthy
+exit 1;

{awslabs_memcached_mcp_server-1.0.2 → awslabs_memcached_mcp_server-1.0.4}/pyproject.toml

@@ -1,12 +1,12 @@
 [project]
 name = "awslabs.memcached-mcp-server"
-version = "1.0.2"
+version = "1.0.4"
 description = "An AWS Labs Model Context Protocol (MCP) server for Amazon ElastiCache Memcached"
 readme = "README.md"
 requires-python = ">=3.10"
 dependencies = [
     "loguru>=0.7.0",
-    "mcp[cli]>=1.6.0",
+    "mcp[cli]>=1.11.0",
     "pydantic>=2.10.6",
     "pymemcache>=4.0.0",
     "python-dotenv>=0.9.9"