awslabs.memcached-mcp-server 0.1.2__tar.gz → 1.0.1__tar.gz

{awslabs_memcached_mcp_server-0.1.2 → awslabs_memcached_mcp_server-1.0.1}/Dockerfile

@@ -1,16 +1,19 @@
 # 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. A copy of the License is located at
+# 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
+#     http://www.apache.org/licenses/LICENSE-2.0
 #
-# or in the 'license' file accompanying this file. This file is distributed on an 'AS IS' BASIS, WITHOUT WARRANTIES
-# OR CONDITIONS OF ANY KIND, express or implied. See the License for the specific language governing permissions
-# and limitations under the License.
+# 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.
 
 #FROM public.ecr.aws/sam/build-python3.10:1.137.1-20250411084548
-FROM public.ecr.aws/sam/build-python3.10@sha256:a40f492a0cd8d76557f8a187fc00e49e8864b3cea683e74718ce317790c1ce61 AS uv
+FROM public.ecr.aws/sam/build-python3.10@sha256:e78695db10ca8cb129e59e30f7dc9789b0dbd0181dba195d68419c72bac51ac1 AS uv
 
 # Install the project into `/app`
 WORKDIR /app
@@ -44,7 +47,7 @@ RUN --mount=type=cache,target=/root/.cache/uv \
 # Make the directory just in case it doesn't exist
 RUN mkdir -p /root/.local
 
-FROM public.ecr.aws/sam/build-python3.10@sha256:a40f492a0cd8d76557f8a187fc00e49e8864b3cea683e74718ce317790c1ce61
+FROM public.ecr.aws/sam/build-python3.10@sha256:e78695db10ca8cb129e59e30f7dc9789b0dbd0181dba195d68419c72bac51ac1
 
 # Place executables in the environment at the front of the path and include other binaries
 ENV PATH="/app/.venv/bin:$PATH:/usr/sbin"

{awslabs_memcached_mcp_server-0.1.2 → awslabs_memcached_mcp_server-1.0.1}/ELASTICACHECONNECT.md

@@ -1,5 +1,9 @@
 # How to connect to an Amazon ElastiCache Memcached cache
 
+Your Amazon ElastiCache instances are designed to be accessed through an Amazon EC2 instance. You can access your ElastiCache instance from an Amazon EC2 instance in the same Amazon VPC, or by using VPC peering, you can access your ElastiCache instance from an Amazon EC2 in a different Amazon VPC.
+
+The following instructions will help you create an EC2 instance in the same VPC as your cache instance, and will guide you to configure the security groups required to access the cache from your desktop through an SSH tunnel.
+
 ## Launch and configure the EC2 instance
 
 Complete the following steps:

{awslabs_memcached_mcp_server-0.1.2 → awslabs_memcached_mcp_server-1.0.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: awslabs.memcached-mcp-server
-Version: 0.1.2
+Version: 1.0.1
 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/

awslabs_memcached_mcp_server-1.0.1/awslabs/__init__.py

@@ -0,0 +1,16 @@
+# 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.
+
+# This file is part of the awslabs namespace.
+# It is intentionally minimal to support PEP 420 namespace packages.

awslabs_memcached_mcp_server-1.0.1/awslabs/memcached_mcp_server/__init__.py

@@ -0,0 +1,17 @@
+# 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.
+
+"""awslabs.memcached-mcp-server"""
+
+__version__ = '0.1.0'

awslabs_memcached_mcp_server-1.0.1/awslabs/memcached_mcp_server/common/config.py

@@ -0,0 +1,21 @@
+# 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.
+
+"""Configuration for Memcached MCP Server."""
+
+from dotenv import load_dotenv
+
+
+# Load environment variables from .env file if present
+load_dotenv()

{awslabs_memcached_mcp_server-0.1.2 → awslabs_memcached_mcp_server-1.0.1}/awslabs/memcached_mcp_server/common/connection.py

@@ -1,3 +1,17 @@
+# 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.
+
 """Connection management for Memcached MCP Server."""
 
 import os

awslabs_memcached_mcp_server-1.0.1/awslabs/memcached_mcp_server/common/server.py

@@ -0,0 +1,28 @@
+# 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.
+
+"""Server initialization for Memcached MCP Server."""
+
+from mcp.server.fastmcp import FastMCP
+
+
+# Create MCP server instance
+mcp = FastMCP(
+    'awslabs.memcached-mcp-server',
+    instructions='Instructions for using this memcached MCP server. This can be used by clients to improve the LLM'
+    's understanding of available tools, resources, etc. It can be thought of like a '
+    'hint'
+    ' to the model. For example, this information MAY be added to the system prompt. Important to be clear, direct, and detailed.',
+    dependencies=['pydantic', 'loguru', 'pymemcache', 'dotenv'],
+)

awslabs_memcached_mcp_server-1.0.1/awslabs/memcached_mcp_server/main.py

@@ -0,0 +1,49 @@
+# 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.
+
+"""awslabs memcached MCP Server implementation."""
+
+from awslabs.memcached_mcp_server.common.server import mcp
+from awslabs.memcached_mcp_server.tools import cache  # noqa: F401
+from loguru import logger
+from starlette.requests import Request  # noqa: F401
+from starlette.responses import Response
+
+
+# Add a health check route directly to the MCP server
+@mcp.custom_route('/health', methods=['GET'])
+async def health_check(request):
+    """Simple health check endpoint for ALB Target Group.
+
+    Always returns 200 OK to indicate the service is running.
+    """
+    return Response(content='healthy', status_code=200, media_type='text/plain')
+
+
+class MemcachedMCPServer:
+    """Memcached MCP Server wrapper."""
+
+    def run(self):
+        """Run server with appropriate transport."""
+        mcp.run()
+
+
+def main():
+    """Run the MCP server with CLI argument support."""
+    logger.info('Amazon ElastiCache Memcached MCP Server Started...')
+    MemcachedMCPServer().run()
+
+
+if __name__ == '__main__':
+    main()

{awslabs_memcached_mcp_server-0.1.2 → awslabs_memcached_mcp_server-1.0.1}/awslabs/memcached_mcp_server/tools/cache.py

@@ -1,3 +1,17 @@
+# 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.
+
 """Cache operations for Memcached MCP Server."""
 
 from awslabs.memcached_mcp_server.common.connection import MemcachedConnectionManager

awslabs_memcached_mcp_server-1.0.1/docker-healthcheck.sh

@@ -0,0 +1,26 @@
+#!/bin/sh
+
+# 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.
+
+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";
+  exit 0;
+else
+  echo -n "Zero awslabs.* streams found";
+  exit 1;
+fi;
+
+echo -n "Never should reach here";
+exit 99;

{awslabs_memcached_mcp_server-0.1.2 → awslabs_memcached_mcp_server-1.0.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "awslabs.memcached-mcp-server"
-version = "0.1.2"
+version = "1.0.1"
 description = "An AWS Labs Model Context Protocol (MCP) server for Amazon ElastiCache Memcached"
 readme = "README.md"
 requires-python = ">=3.10"

{awslabs_memcached_mcp_server-0.1.2 → awslabs_memcached_mcp_server-1.0.1}/tests/test_init.py

@@ -1,13 +1,16 @@
 # 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. A copy of the License is located at
+# 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
+#     http://www.apache.org/licenses/LICENSE-2.0
 #
-# or in the 'license' file accompanying this file. This file is distributed on an 'AS IS' BASIS, WITHOUT WARRANTIES
-# OR CONDITIONS OF ANY KIND, express or implied. See the License for the specific language governing permissions
-# and limitations under the License.
+# 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.
 """Tests for the awslabs.memcached-mcp-server package."""
 
 import importlib

{awslabs_memcached_mcp_server-0.1.2 → awslabs_memcached_mcp_server-1.0.1}/tests/test_main.py

@@ -1,13 +1,16 @@
 # 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. A copy of the License is located at
+# 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
+#     http://www.apache.org/licenses/LICENSE-2.0
 #
-# or in the 'license' file accompanying this file. This file is distributed on an 'AS IS' BASIS, WITHOUT WARRANTIES
-# OR CONDITIONS OF ANY KIND, express or implied. See the License for the specific language governing permissions
-# and limitations under the License.
+# 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.
 """Tests for the main function in server.py."""
 
 from awslabs.memcached_mcp_server.main import main
@@ -26,23 +29,6 @@ class TestMain:
 
         # Check that mcp.run was called with the correct arguments
         mock_run.assert_called_once()
-        assert mock_run.call_args[1].get('transport') is None
-
-    @patch('awslabs.memcached_mcp_server.common.server.mcp.run')
-    @patch('sys.argv', ['awslabs.memcached-mcp-server', '--sse', '--port', '9999'])
-    def test_main_sse(self, mock_run):
-        """Test main function with SSE transport."""
-        # Call the main function
-        main()
-
-        # Check that mcp.run was called with the correct arguments
-        mock_run.assert_called_once()
-        assert mock_run.call_args[1].get('transport') == 'sse'
-
-        # Check that the port was set correctly
-        from awslabs.memcached_mcp_server.main import mcp
-
-        assert mcp.settings.port == 9999
 
     def test_module_execution(self):
         """Test the module execution when run as __main__."""

awslabs_memcached_mcp_server-0.1.2/awslabs/__init__.py

@@ -1,13 +0,0 @@
-# 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. A copy of the License is located at
-#
-#    http://www.apache.org/licenses/LICENSE-2.0
-#
-# or in the 'license' file accompanying this file. This file is distributed on an 'AS IS' BASIS, WITHOUT WARRANTIES
-# OR CONDITIONS OF ANY KIND, express or implied. See the License for the specific language governing permissions
-# and limitations under the License.
-
-# This file is part of the awslabs namespace.
-# It is intentionally minimal to support PEP 420 namespace packages.

awslabs_memcached_mcp_server-0.1.2/awslabs/memcached_mcp_server/__init__.py

@@ -1,14 +0,0 @@
-# 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. A copy of the License is located at
-#
-#    http://www.apache.org/licenses/LICENSE-2.0
-#
-# or in the 'license' file accompanying this file. This file is distributed on an 'AS IS' BASIS, WITHOUT WARRANTIES
-# OR CONDITIONS OF ANY KIND, express or implied. See the License for the specific language governing permissions
-# and limitations under the License.
-
-"""awslabs.memcached-mcp-server"""
-
-__version__ = '0.1.0'

awslabs_memcached_mcp_server-0.1.2/awslabs/memcached_mcp_server/common/config.py

@@ -1,7 +0,0 @@
-"""Configuration for Memcached MCP Server."""
-
-from dotenv import load_dotenv
-
-
-# Load environment variables from .env file if present
-load_dotenv()

awslabs_memcached_mcp_server-0.1.2/awslabs/memcached_mcp_server/common/server.py

@@ -1,14 +0,0 @@
-"""Server initialization for Memcached MCP Server."""
-
-from mcp.server.fastmcp import FastMCP
-
-
-# Create MCP server instance
-mcp = FastMCP(
-    'awslabs.memcached-mcp-server',
-    instructions='Instructions for using this memcached MCP server. This can be used by clients to improve the LLM'
-    's understanding of available tools, resources, etc. It can be thought of like a '
-    'hint'
-    ' to the model. For example, this information MAY be added to the system prompt. Important to be clear, direct, and detailed.',
-    dependencies=['pydantic', 'loguru', 'pymemcache', 'dotenv'],
-)

awslabs_memcached_mcp_server-0.1.2/awslabs/memcached_mcp_server/main.py

@@ -1,67 +0,0 @@
-# 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. A copy of the License is located at
-#
-#    http://www.apache.org/licenses/LICENSE-2.0
-#
-# or in the 'license' file accompanying this file. This file is distributed on an 'AS IS' BASIS, WITHOUT WARRANTIES
-# OR CONDITIONS OF ANY KIND, express or implied. See the License for the specific language governing permissions
-# and limitations under the License.
-
-"""awslabs memcached MCP Server implementation."""
-
-import argparse
-from awslabs.memcached_mcp_server.common.server import mcp
-from awslabs.memcached_mcp_server.tools import cache  # noqa: F401
-from loguru import logger
-from starlette.requests import Request  # noqa: F401
-from starlette.responses import Response
-
-
-# Add a health check route directly to the MCP server
-@mcp.custom_route('/health', methods=['GET'])
-async def health_check(request):
-    """Simple health check endpoint for ALB Target Group.
-
-    Always returns 200 OK to indicate the service is running.
-    """
-    return Response(content='healthy', status_code=200, media_type='text/plain')
-
-
-class MemcachedMCPServer:
-    """Memcached MCP Server wrapper."""
-
-    def __init__(self, sse=False, port=None):
-        """Initialize MCP Server wrapper."""
-        self.sse = sse
-        self.port = port
-
-    def run(self):
-        """Run server with appropriate transport."""
-        if self.sse:
-            mcp.settings.port = int(self.port) if self.port is not None else 8888
-            mcp.run(transport='sse')
-        else:
-            mcp.run()
-
-
-def main():
-    """Run the MCP server with CLI argument support."""
-    parser = argparse.ArgumentParser(
-        description='An AWS Labs Model Context Protocol (MCP) server for Amazon ElastiCache Memcached'
-    )
-    parser.add_argument('--sse', action='store_true', help='Use SSE transport')
-    parser.add_argument('--port', type=int, default=8888, help='Port to run the server on')
-
-    args = parser.parse_args()
-
-    logger.info('Amazon ElastiCache Memcached MCP Server Started...')
-
-    # Run server with appropriate transport
-    server = MemcachedMCPServer(args.sse, args.port)
-    server.run()
-
-
-if __name__ == '__main__':
-    main()

awslabs_memcached_mcp_server-0.1.2/docker-healthcheck.sh

@@ -1,12 +0,0 @@
-#!/bin/sh
-
-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";
-  exit 0;
-else
-  echo -n "Zero awslabs.* streams found";
-  exit 1;
-fi;
-
-echo -n "Never should reach here";
-exit 99;