container-manager-mcp 1.0.6__py3-none-any.whl → 1.1.0__py3-none-any.whl

container_manager_mcp/__init__.py

@@ -8,7 +8,7 @@ from container_manager_mcp.container_manager import (
     DockerManager,
     PodmanManager,
 )
-from container_manager_mcp.container_manager_mcp import main
+from container_manager_mcp.container_manager_mcp import container_manager_mcp
 
 """
 container-manager
@@ -17,7 +17,7 @@ Manage your containers using docker, podman, compose, or docker swarm!
 """
 
 __all__ = [
-    "main",
+    "container_manager_mcp",
     "create_manager",
     "container_manager",
     "ContainerManagerBase",

container_manager_mcp/__main__.py

@@ -1,6 +1,6 @@
 #!/usr/bin/python
 # coding: utf-8
-from container_manager_mcp.container_manager_mcp import main
+from container_manager_mcp.container_manager_mcp import container_manager_mcp
 
 if __name__ == "__main__":
-    main()
+    container_manager_mcp()

container_manager_mcp/container_manager.py

@@ -510,14 +510,17 @@ class DockerManager(ContainerManagerBase):
                 self.log_action("run_container", params, result)
                 return result
             attrs = container.attrs
-            ports = attrs.get("NetworkSettings", {}).get("Ports", {})
             port_mappings = []
-            for container_port, host_ports in ports.items():
-                if host_ports:
-                    for hp in host_ports:
-                        port_mappings.append(
-                            f"{hp.get('HostIp', '0.0.0.0')}:{hp.get('HostPort')}->{container_port}"
-                        )
+            if ports:  # Check if ports is not None
+                network_settings = attrs.get("NetworkSettings", {})
+                container_ports = network_settings.get("Ports", {})
+                if container_ports:  # Check if Ports dictionary is not empty
+                    for container_port, host_ports in container_ports.items():
+                        if host_ports:  # Check if host_ports is not None or empty
+                            for hp in host_ports:
+                                port_mappings.append(
+                                    f"{hp.get('HostIp', '0.0.0.0')}:{hp.get('HostPort')}->{container_port}"
+                                )
             created = attrs.get("Created", None)
             created_str = self._parse_timestamp(created)
             result = {
@@ -1057,9 +1060,11 @@ class PodmanManager(ContainerManagerBase):
 
     def _autodetect_podman_url(self) -> Optional[str]:
         """Autodetect the appropriate Podman socket URL based on platform."""
-        base_url = os.environ.get("PODMAN_BASE_URL")
+        base_url = os.environ.get("CONTAINER_MANAGER_PODMAN_BASE_URL")
         if base_url:
-            self.logger.info(f"Using PODMAN_BASE_URL from environment: {base_url}")
+            self.logger.info(
+                f"Using CONTAINER_MANAGER_PODMAN_BASE_URL from environment: {base_url}"
+            )
             return base_url
         system = platform.system()
         is_wsl = self._is_wsl()
@@ -1069,6 +1074,7 @@ class PodmanManager(ContainerManagerBase):
                 raise RuntimeError("Podman Machine is not running on Windows system")
             socket_candidates.extend(
                 [
+                    "tcp://127.0.0.1:8080",
                     "unix:///run/podman/podman.sock",
                     "npipe:////./pipe/docker_engine",
                     "unix:///mnt/wsl/podman-sockets/podman-machine-default/podman-user.sock",
@@ -1430,12 +1436,15 @@ class PodmanManager(ContainerManagerBase):
                 self.log_action("run_container", params, result)
                 return result
             attrs = container.attrs
-            ports = attrs.get("Ports", [])
-            port_mappings = [
-                f"{p.get('host_ip', '0.0.0.0')}:{p.get('host_port')}->{p.get('container_port')}/{p.get('protocol', 'tcp')}"
-                for p in ports
-                if p.get("host_port")
-            ]
+            port_mappings = []
+            if ports:  # Check if ports is not None
+                container_ports = attrs.get("Ports", [])
+                if container_ports:  # Check if Ports list is not empty
+                    port_mappings = [
+                        f"{p.get('host_ip', '0.0.0.0')}:{p.get('host_port')}->{p.get('container_port')}/{p.get('protocol', 'tcp')}"
+                        for p in container_ports
+                        if p.get("host_port")
+                    ]
             created = attrs.get("Created", None)
             created_str = self._parse_timestamp(created)
             result = {

container_manager_mcp/container_manager_mcp.py

@@ -62,16 +62,6 @@ def parse_image_string(image: str, default_tag: str = "latest") -> tuple[str, st
     return image, default_tag
 
 
-environment_silent = os.environ.get("SILENT", False)
-environment_log_file = os.environ.get("LOG_FILE", None)
-environment_container_manager_type = os.environ.get("CONTAINER_MANAGER_TYPE", None)
-
-if environment_silent:
-    environment_silent = to_boolean(environment_silent)
-
-# Common tools
-
-
 @mcp.tool(
     annotations={
         "title": "Get Version",
@@ -85,18 +75,24 @@ if environment_silent:
 async def get_version(
     manager_type: Optional[str] = Field(
         description="Container manager: docker, podman (default: auto-detect)",
-        default=environment_container_manager_type,
+        default=os.environ.get("CONTAINER_MANAGER_TYPE", None),
     ),
     silent: Optional[bool] = Field(
-        description="Suppress output", default=environment_silent
+        description="Suppress output",
+        default=to_boolean(os.environ.get("CONTAINER_MANAGER_SILENT", False)),
     ),
     log_file: Optional[str] = Field(
-        description="Path to log file", default=environment_log_file
+        description="Path to log file",
+        default=os.environ.get("CONTAINER_MANAGER_LOG_FILE", None),
     ),
     ctx: Context = Field(
         description="MCP context for progress reporting", default=None
     ),
 ) -> Dict:
+    """
+    Retrieves the version information of the container manager (Docker or Podman).
+    Returns: A dictionary with keys like 'version', 'api_version', etc., detailing the manager's version.
+    """
     logger = logging.getLogger("ContainerManager")
     logger.debug(
         f"Getting version for {manager_type}, silent: {silent}, log_file: {log_file}"
@@ -122,18 +118,24 @@ async def get_version(
 async def get_info(
     manager_type: Optional[str] = Field(
         description="Container manager: docker, podman (default: auto-detect)",
-        default=environment_container_manager_type,
+        default=os.environ.get("CONTAINER_MANAGER_TYPE", None),
     ),
     silent: Optional[bool] = Field(
-        description="Suppress output", default=environment_silent
+        description="Suppress output",
+        default=to_boolean(os.environ.get("CONTAINER_MANAGER_SILENT", False)),
     ),
     log_file: Optional[str] = Field(
-        description="Path to log file", default=environment_log_file
+        description="Path to log file",
+        default=os.environ.get("CONTAINER_MANAGER_LOG_FILE", None),
     ),
     ctx: Context = Field(
         description="MCP context for progress reporting", default=None
     ),
 ) -> Dict:
+    """
+    Retrieves detailed information about the container manager system.
+    Returns: A dictionary containing system info such as OS, architecture, storage driver, and more.
+    """
     logger = logging.getLogger("ContainerManager")
     logger.debug(
         f"Getting info for {manager_type}, silent: {silent}, log_file: {log_file}"
@@ -159,18 +161,24 @@ async def get_info(
 async def list_images(
     manager_type: Optional[str] = Field(
         description="Container manager: docker, podman (default: auto-detect)",
-        default=environment_container_manager_type,
+        default=os.environ.get("CONTAINER_MANAGER_TYPE", None),
     ),
     silent: Optional[bool] = Field(
-        description="Suppress output", default=environment_silent
+        description="Suppress output",
+        default=to_boolean(os.environ.get("CONTAINER_MANAGER_SILENT", False)),
     ),
     log_file: Optional[str] = Field(
-        description="Path to log file", default=environment_log_file
+        description="Path to log file",
+        default=os.environ.get("CONTAINER_MANAGER_LOG_FILE", None),
     ),
     ctx: Context = Field(
         description="MCP context for progress reporting", default=None
     ),
 ) -> List[Dict]:
+    """
+    Lists all container images available on the system.
+    Returns: A list of dictionaries, each with image details like 'id', 'tags', 'created', 'size'.
+    """
     logger = logging.getLogger("ContainerManager")
     logger.debug(
         f"Listing images for {manager_type}, silent: {silent}, log_file: {log_file}"
@@ -206,18 +214,24 @@ async def pull_image(
     ),
     manager_type: Optional[str] = Field(
         description="Container manager: docker, podman (default: auto-detect)",
-        default=environment_container_manager_type,
+        default=os.environ.get("CONTAINER_MANAGER_TYPE", None),
     ),
     silent: Optional[bool] = Field(
-        description="Suppress output", default=environment_silent
+        description="Suppress output",
+        default=to_boolean(os.environ.get("CONTAINER_MANAGER_SILENT", False)),
     ),
     log_file: Optional[str] = Field(
-        description="Path to log file", default=environment_log_file
+        description="Path to log file",
+        default=os.environ.get("CONTAINER_MANAGER_LOG_FILE", None),
     ),
     ctx: Context = Field(
         description="MCP context for progress reporting", default=None
     ),
 ) -> Dict:
+    """
+    Pulls a container image from a registry.
+    Returns: A dictionary with the pull status, including 'id' of the pulled image and any error messages.
+    """
     logger = logging.getLogger("ContainerManager")
     # Parse image string to separate image and tag
     parsed_image, parsed_tag = parse_image_string(image, tag)
@@ -247,18 +261,24 @@ async def remove_image(
     force: bool = Field(description="Force removal", default=False),
     manager_type: Optional[str] = Field(
         description="Container manager: docker, podman (default: auto-detect)",
-        default=environment_container_manager_type,
+        default=os.environ.get("CONTAINER_MANAGER_TYPE", None),
     ),
     silent: Optional[bool] = Field(
-        description="Suppress output", default=environment_silent
+        description="Suppress output",
+        default=to_boolean(os.environ.get("CONTAINER_MANAGER_SILENT", False)),
     ),
     log_file: Optional[str] = Field(
-        description="Path to log file", default=environment_log_file
+        description="Path to log file",
+        default=os.environ.get("CONTAINER_MANAGER_LOG_FILE", None),
     ),
     ctx: Context = Field(
         description="MCP context for progress reporting", default=None
     ),
 ) -> Dict:
+    """
+    Removes a specified container image.
+    Returns: A dictionary indicating success or failure, with details like removed image ID.
+    """
     logger = logging.getLogger("ContainerManager")
     logger.debug(
         f"Removing image {image} for {manager_type}, silent: {silent}, log_file: {log_file}"
@@ -285,18 +305,24 @@ async def prune_images(
     all: bool = Field(description="Prune all unused images", default=False),
     manager_type: Optional[str] = Field(
         description="Container manager: docker, podman (default: auto-detect)",
-        default=environment_container_manager_type,
+        default=os.environ.get("CONTAINER_MANAGER_TYPE", None),
     ),
     silent: Optional[bool] = Field(
-        description="Suppress output", default=environment_silent
+        description="Suppress output",
+        default=to_boolean(os.environ.get("CONTAINER_MANAGER_SILENT", False)),
     ),
     log_file: Optional[str] = Field(
-        description="Path to log file", default=environment_log_file
+        description="Path to log file",
+        default=os.environ.get("CONTAINER_MANAGER_LOG_FILE", None),
     ),
     ctx: Context = Field(
         description="MCP context for progress reporting", default=None
     ),
 ) -> Dict:
+    """
+    Prunes unused container images.
+    Returns: A dictionary with prune results, including space reclaimed and list of deleted images.
+    """
     logger = logging.getLogger("ContainerManager")
     logger.debug(
         f"Pruning images for {manager_type}, all: {all}, silent: {silent}, log_file: {log_file}"
@@ -325,18 +351,24 @@ async def list_containers(
     ),
     manager_type: Optional[str] = Field(
         description="Container manager: docker, podman (default: auto-detect)",
-        default=environment_container_manager_type,
+        default=os.environ.get("CONTAINER_MANAGER_TYPE", None),
     ),
     silent: Optional[bool] = Field(
-        description="Suppress output", default=environment_silent
+        description="Suppress output",
+        default=to_boolean(os.environ.get("CONTAINER_MANAGER_SILENT", False)),
     ),
     log_file: Optional[str] = Field(
-        description="Path to log file", default=environment_log_file
+        description="Path to log file",
+        default=os.environ.get("CONTAINER_MANAGER_LOG_FILE", None),
     ),
     ctx: Context = Field(
         description="MCP context for progress reporting", default=None
     ),
 ) -> List[Dict]:
+    """
+    Lists containers on the system.
+    Returns: A list of dictionaries, each with container details like 'id', 'name', 'status', 'image'.
+    """
     logger = logging.getLogger("ContainerManager")
     logger.debug(
         f"Listing containers for {manager_type}, all: {all}, silent: {silent}, log_file: {log_file}"
@@ -378,18 +410,24 @@ async def run_container(
     ),
     manager_type: Optional[str] = Field(
         description="Container manager: docker, podman (default: auto-detect)",
-        default=environment_container_manager_type,
+        default=os.environ.get("CONTAINER_MANAGER_TYPE", None),
     ),
     silent: Optional[bool] = Field(
-        description="Suppress output", default=environment_silent
+        description="Suppress output",
+        default=to_boolean(os.environ.get("CONTAINER_MANAGER_SILENT", False)),
     ),
     log_file: Optional[str] = Field(
-        description="Path to log file", default=environment_log_file
+        description="Path to log file",
+        default=os.environ.get("CONTAINER_MANAGER_LOG_FILE", None),
     ),
     ctx: Context = Field(
         description="MCP context for progress reporting", default=None
     ),
 ) -> Dict:
+    """
+    Runs a new container from the specified image.
+    Returns: A dictionary with the container's ID and status after starting.
+    """
     logger = logging.getLogger("ContainerManager")
     logger.debug(
         f"Running container from {image} for {manager_type}, silent: {silent}, log_file: {log_file}"
@@ -419,18 +457,24 @@ async def stop_container(
     timeout: int = Field(description="Timeout in seconds", default=10),
     manager_type: Optional[str] = Field(
         description="Container manager: docker, podman (default: auto-detect)",
-        default=environment_container_manager_type,
+        default=os.environ.get("CONTAINER_MANAGER_TYPE", None),
     ),
     silent: Optional[bool] = Field(
-        description="Suppress output", default=environment_silent
+        description="Suppress output",
+        default=to_boolean(os.environ.get("CONTAINER_MANAGER_SILENT", False)),
     ),
     log_file: Optional[str] = Field(
-        description="Path to log file", default=environment_log_file
+        description="Path to log file",
+        default=os.environ.get("CONTAINER_MANAGER_LOG_FILE", None),
     ),
     ctx: Context = Field(
         description="MCP context for progress reporting", default=None
     ),
 ) -> Dict:
+    """
+    Stops a running container.
+    Returns: A dictionary confirming the stop action, with container ID and any errors.
+    """
     logger = logging.getLogger("ContainerManager")
     logger.debug(
         f"Stopping container {container_id} for {manager_type}, silent: {silent}, log_file: {log_file}"
@@ -458,18 +502,24 @@ async def remove_container(
     force: bool = Field(description="Force removal", default=False),
     manager_type: Optional[str] = Field(
         description="Container manager: docker, podman (default: auto-detect)",
-        default=environment_container_manager_type,
+        default=os.environ.get("CONTAINER_MANAGER_TYPE", None),
     ),
     silent: Optional[bool] = Field(
-        description="Suppress output", default=environment_silent
+        description="Suppress output",
+        default=to_boolean(os.environ.get("CONTAINER_MANAGER_SILENT", False)),
     ),
     log_file: Optional[str] = Field(
-        description="Path to log file", default=environment_log_file
+        description="Path to log file",
+        default=os.environ.get("CONTAINER_MANAGER_LOG_FILE", None),
     ),
     ctx: Context = Field(
         description="MCP context for progress reporting", default=None
     ),
 ) -> Dict:
+    """
+    Removes a container.
+    Returns: A dictionary with removal status, including deleted container ID.
+    """
     logger = logging.getLogger("ContainerManager")
     logger.debug(
         f"Removing container {container_id} for {manager_type}, silent: {silent}, log_file: {log_file}"
@@ -495,18 +545,24 @@ async def remove_container(
 async def prune_containers(
     manager_type: Optional[str] = Field(
         description="Container manager: docker, podman (default: auto-detect)",
-        default=environment_container_manager_type,
+        default=os.environ.get("CONTAINER_MANAGER_TYPE", None),
     ),
     silent: Optional[bool] = Field(
-        description="Suppress output", default=environment_silent
+        description="Suppress output",
+        default=to_boolean(os.environ.get("CONTAINER_MANAGER_SILENT", False)),
     ),
     log_file: Optional[str] = Field(
-        description="Path to log file", default=environment_log_file
+        description="Path to log file",
+        default=os.environ.get("CONTAINER_MANAGER_LOG_FILE", None),
     ),
     ctx: Context = Field(
         description="MCP context for progress reporting", default=None
     ),
 ) -> Dict:
+    """
+    Prunes stopped containers.
+    Returns: A dictionary with prune results, including space reclaimed and deleted containers.
+    """
     logger = logging.getLogger("ContainerManager")
     logger.debug(
         f"Pruning containers for {manager_type}, silent: {silent}, log_file: {log_file}"
@@ -536,18 +592,24 @@ async def get_container_logs(
     ),
     manager_type: Optional[str] = Field(
         description="Container manager: docker, podman (default: auto-detect)",
-        default=environment_container_manager_type,
+        default=os.environ.get("CONTAINER_MANAGER_TYPE", None),
     ),
     silent: Optional[bool] = Field(
-        description="Suppress output", default=environment_silent
+        description="Suppress output",
+        default=to_boolean(os.environ.get("CONTAINER_MANAGER_SILENT", False)),
     ),
     log_file: Optional[str] = Field(
-        description="Path to log file", default=environment_log_file
+        description="Path to log file",
+        default=os.environ.get("CONTAINER_MANAGER_LOG_FILE", None),
     ),
     ctx: Context = Field(
         description="MCP context for progress reporting", default=None
     ),
 ) -> str:
+    """
+    Retrieves logs from a container.
+    Returns: A string containing the log output, parse as plain text lines.
+    """
     logger = logging.getLogger("ContainerManager")
     logger.debug(
         f"Getting logs for container {container_id} for {manager_type}, silent: {silent}, log_file: {log_file}"
@@ -576,18 +638,24 @@ async def exec_in_container(
     detach: bool = Field(description="Detach execution", default=False),
     manager_type: Optional[str] = Field(
         description="Container manager: docker, podman (default: auto-detect)",
-        default=environment_container_manager_type,
+        default=os.environ.get("CONTAINER_MANAGER_TYPE", None),
     ),
     silent: Optional[bool] = Field(
-        description="Suppress output", default=environment_silent
+        description="Suppress output",
+        default=to_boolean(os.environ.get("CONTAINER_MANAGER_SILENT", False)),
     ),
     log_file: Optional[str] = Field(
-        description="Path to log file", default=environment_log_file
+        description="Path to log file",
+        default=os.environ.get("CONTAINER_MANAGER_LOG_FILE", None),
     ),
     ctx: Context = Field(
         description="MCP context for progress reporting", default=None
     ),
 ) -> Dict:
+    """
+    Executes a command inside a running container.
+    Returns: A dictionary with execution results, including 'exit_code' and 'output' as string.
+    """
     logger = logging.getLogger("ContainerManager")
     logger.debug(
         f"Executing {command} in container {container_id} for {manager_type}, silent: {silent}, log_file: {log_file}"
@@ -613,18 +681,24 @@ async def exec_in_container(
 async def list_volumes(
     manager_type: Optional[str] = Field(
         description="Container manager: docker, podman (default: auto-detect)",
-        default=environment_container_manager_type,
+        default=os.environ.get("CONTAINER_MANAGER_TYPE", None),
     ),
     silent: Optional[bool] = Field(
-        description="Suppress output", default=environment_silent
+        description="Suppress output",
+        default=to_boolean(os.environ.get("CONTAINER_MANAGER_SILENT", False)),
     ),
     log_file: Optional[str] = Field(
-        description="Path to log file", default=environment_log_file
+        description="Path to log file",
+        default=os.environ.get("CONTAINER_MANAGER_LOG_FILE", None),
     ),
     ctx: Context = Field(
         description="MCP context for progress reporting", default=None
     ),
 ) -> Dict:
+    """
+    Lists all volumes.
+    Returns: A dictionary with 'volumes' as a list of dicts containing name, driver, mountpoint, etc.
+    """
     logger = logging.getLogger("ContainerManager")
     logger.debug(
         f"Listing volumes for {manager_type}, silent: {silent}, log_file: {log_file}"
@@ -651,18 +725,24 @@ async def create_volume(
     name: str = Field(description="Volume name"),
     manager_type: Optional[str] = Field(
         description="Container manager: docker, podman (default: auto-detect)",
-        default=environment_container_manager_type,
+        default=os.environ.get("CONTAINER_MANAGER_TYPE", None),
     ),
     silent: Optional[bool] = Field(
-        description="Suppress output", default=environment_silent
+        description="Suppress output",
+        default=to_boolean(os.environ.get("CONTAINER_MANAGER_SILENT", False)),
     ),
     log_file: Optional[str] = Field(
-        description="Path to log file", default=environment_log_file
+        description="Path to log file",
+        default=os.environ.get("CONTAINER_MANAGER_LOG_FILE", None),
     ),
     ctx: Context = Field(
         description="MCP context for progress reporting", default=None
     ),
 ) -> Dict:
+    """
+    Creates a new volume.
+    Returns: A dictionary with details of the created volume, like 'name' and 'mountpoint'.
+    """
     logger = logging.getLogger("ContainerManager")
     logger.debug(
         f"Creating volume {name} for {manager_type}, silent: {silent}, log_file: {log_file}"
@@ -690,18 +770,24 @@ async def remove_volume(
     force: bool = Field(description="Force removal", default=False),
     manager_type: Optional[str] = Field(
         description="Container manager: docker, podman (default: auto-detect)",
-        default=environment_container_manager_type,
+        default=os.environ.get("CONTAINER_MANAGER_TYPE", None),
     ),
     silent: Optional[bool] = Field(
-        description="Suppress output", default=environment_silent
+        description="Suppress output",
+        default=to_boolean(os.environ.get("CONTAINER_MANAGER_SILENT", False)),
     ),
     log_file: Optional[str] = Field(
-        description="Path to log file", default=environment_log_file
+        description="Path to log file",
+        default=os.environ.get("CONTAINER_MANAGER_LOG_FILE", None),
     ),
     ctx: Context = Field(
         description="MCP context for progress reporting", default=None
     ),
 ) -> Dict:
+    """
+    Removes a volume.
+    Returns: A dictionary confirming removal, with deleted volume name.
+    """
     logger = logging.getLogger("ContainerManager")
     logger.debug(
         f"Removing volume {name} for {manager_type}, silent: {silent}, log_file: {log_file}"
@@ -728,18 +814,24 @@ async def prune_volumes(
     all: bool = Field(description="Remove all volumes (dangerous)", default=False),
     manager_type: Optional[str] = Field(
         description="Container manager: docker, podman (default: auto-detect)",
-        default=environment_container_manager_type,
+        default=os.environ.get("CONTAINER_MANAGER_TYPE", None),
     ),
     silent: Optional[bool] = Field(
-        description="Suppress output", default=environment_silent
+        description="Suppress output",
+        default=to_boolean(os.environ.get("CONTAINER_MANAGER_SILENT", False)),
     ),
     log_file: Optional[str] = Field(
-        description="Path to log file", default=environment_log_file
+        description="Path to log file",
+        default=os.environ.get("CONTAINER_MANAGER_LOG_FILE", None),
     ),
     ctx: Context = Field(
         description="MCP context for progress reporting", default=None
     ),
 ) -> Dict:
+    """
+    Prunes unused volumes.
+    Returns: A dictionary with prune results, including space reclaimed and deleted volumes.
+    """
     logger = logging.getLogger("ContainerManager")
     logger.debug(
         f"Pruning volumes for {manager_type}, all: {all}, silent: {silent}, log_file: {log_file}"
@@ -765,18 +857,24 @@ async def prune_volumes(
 async def list_networks(
     manager_type: Optional[str] = Field(
         description="Container manager: docker, podman (default: auto-detect)",
-        default=environment_container_manager_type,
+        default=os.environ.get("CONTAINER_MANAGER_TYPE", None),
     ),
     silent: Optional[bool] = Field(
-        description="Suppress output", default=environment_silent
+        description="Suppress output",
+        default=to_boolean(os.environ.get("CONTAINER_MANAGER_SILENT", False)),
     ),
     log_file: Optional[str] = Field(
-        description="Path to log file", default=environment_log_file
+        description="Path to log file",
+        default=os.environ.get("CONTAINER_MANAGER_LOG_FILE", None),
     ),
     ctx: Context = Field(
         description="MCP context for progress reporting", default=None
     ),
 ) -> List[Dict]:
+    """
+    Lists all networks.
+    Returns: A list of dictionaries, each with network details like 'id', 'name', 'driver', 'scope'.
+    """
     logger = logging.getLogger("ContainerManager")
     logger.debug(
         f"Listing networks for {manager_type}, silent: {silent}, log_file: {log_file}"
@@ -804,18 +902,24 @@ async def create_network(
     driver: str = Field(description="Network driver (e.g., bridge)", default="bridge"),
     manager_type: Optional[str] = Field(
         description="Container manager: docker, podman (default: auto-detect)",
-        default=environment_container_manager_type,
+        default=os.environ.get("CONTAINER_MANAGER_TYPE", None),
     ),
     silent: Optional[bool] = Field(
-        description="Suppress output", default=environment_silent
+        description="Suppress output",
+        default=to_boolean(os.environ.get("CONTAINER_MANAGER_SILENT", False)),
     ),
     log_file: Optional[str] = Field(
-        description="Path to log file", default=environment_log_file
+        description="Path to log file",
+        default=os.environ.get("CONTAINER_MANAGER_LOG_FILE", None),
     ),
     ctx: Context = Field(
         description="MCP context for progress reporting", default=None
     ),
 ) -> Dict:
+    """
+    Creates a new network.
+    Returns: A dictionary with the created network's ID and details.
+    """
     logger = logging.getLogger("ContainerManager")
     logger.debug(
         f"Creating network {name} for {manager_type}, silent: {silent}, log_file: {log_file}"
@@ -842,18 +946,24 @@ async def remove_network(
     network_id: str = Field(description="Network ID or name"),
     manager_type: Optional[str] = Field(
         description="Container manager: docker, podman (default: auto-detect)",
-        default=environment_container_manager_type,
+        default=os.environ.get("CONTAINER_MANAGER_TYPE", None),
     ),
     silent: Optional[bool] = Field(
-        description="Suppress output", default=environment_silent
+        description="Suppress output",
+        default=to_boolean(os.environ.get("CONTAINER_MANAGER_SILENT", False)),
     ),
     log_file: Optional[str] = Field(
-        description="Path to log file", default=environment_log_file
+        description="Path to log file",
+        default=os.environ.get("CONTAINER_MANAGER_LOG_FILE", None),
     ),
     ctx: Context = Field(
         description="MCP context for progress reporting", default=None
     ),
 ) -> Dict:
+    """
+    Removes a network.
+    Returns: A dictionary confirming removal, with deleted network ID.
+    """
     logger = logging.getLogger("ContainerManager")
     logger.debug(
         f"Removing network {network_id} for {manager_type}, silent: {silent}, log_file: {log_file}"
@@ -879,18 +989,24 @@ async def remove_network(
 async def prune_networks(
     manager_type: Optional[str] = Field(
         description="Container manager: docker, podman (default: auto-detect)",
-        default=environment_container_manager_type,
+        default=os.environ.get("CONTAINER_MANAGER_TYPE", None),
     ),
     silent: Optional[bool] = Field(
-        description="Suppress output", default=environment_silent
+        description="Suppress output",
+        default=to_boolean(os.environ.get("CONTAINER_MANAGER_SILENT", False)),
     ),
     log_file: Optional[str] = Field(
-        description="Path to log file", default=environment_log_file
+        description="Path to log file",
+        default=os.environ.get("CONTAINER_MANAGER_LOG_FILE", None),
     ),
     ctx: Context = Field(
         description="MCP context for progress reporting", default=None
     ),
 ) -> Dict:
+    """
+    Prunes unused networks.
+    Returns: A dictionary with prune results, including deleted networks.
+    """
     logger = logging.getLogger("ContainerManager")
     logger.debug(
         f"Pruning networks for {manager_type}, silent: {silent}, log_file: {log_file}"
@@ -918,18 +1034,24 @@ async def prune_system(
     all: bool = Field(description="Prune all unused resources", default=False),
     manager_type: Optional[str] = Field(
         description="Container manager: docker, podman (default: auto-detect)",
-        default=environment_container_manager_type,
+        default=os.environ.get("CONTAINER_MANAGER_TYPE", None),
     ),
     silent: Optional[bool] = Field(
-        description="Suppress output", default=environment_silent
+        description="Suppress output",
+        default=to_boolean(os.environ.get("CONTAINER_MANAGER_SILENT", False)),
     ),
     log_file: Optional[str] = Field(
-        description="Path to log file", default=environment_log_file
+        description="Path to log file",
+        default=os.environ.get("CONTAINER_MANAGER_LOG_FILE", None),
     ),
     ctx: Context = Field(
         description="MCP context for progress reporting", default=None
     ),
 ) -> Dict:
+    """
+    Prunes all unused system resources (containers, images, volumes, networks).
+    Returns: A dictionary summarizing the prune operation across resources.
+    """
     logger = logging.getLogger("ContainerManager")
     logger.debug(
         f"Pruning system for {manager_type}, force: {force}, all: {all}, silent: {silent}, log_file: {log_file}"
@@ -961,18 +1083,24 @@ async def init_swarm(
     ),
     manager_type: Optional[str] = Field(
         description="Container manager: must be docker for swarm (default: auto-detect)",
-        default=environment_container_manager_type,
+        default=os.environ.get("CONTAINER_MANAGER_TYPE", None),
     ),
     silent: Optional[bool] = Field(
-        description="Suppress output", default=environment_silent
+        description="Suppress output",
+        default=to_boolean(os.environ.get("CONTAINER_MANAGER_SILENT", False)),
     ),
     log_file: Optional[str] = Field(
-        description="Path to log file", default=environment_log_file
+        description="Path to log file",
+        default=os.environ.get("CONTAINER_MANAGER_LOG_FILE", None),
     ),
     ctx: Context = Field(
         description="MCP context for progress reporting", default=None
     ),
 ) -> Dict:
+    """
+    Initializes a Docker Swarm cluster.
+    Returns: A dictionary with swarm info, including join tokens for manager and worker.
+    """
     if manager_type and manager_type != "docker":
         raise ValueError("Swarm operations are only supported on Docker")
     logger = logging.getLogger("ContainerManager")
@@ -1001,18 +1129,24 @@ async def leave_swarm(
     force: bool = Field(description="Force leave", default=False),
     manager_type: Optional[str] = Field(
         description="Container manager: must be docker for swarm (default: auto-detect)",
-        default=environment_container_manager_type,
+        default=os.environ.get("CONTAINER_MANAGER_TYPE", None),
     ),
     silent: Optional[bool] = Field(
-        description="Suppress output", default=environment_silent
+        description="Suppress output",
+        default=to_boolean(os.environ.get("CONTAINER_MANAGER_SILENT", False)),
     ),
     log_file: Optional[str] = Field(
-        description="Path to log file", default=environment_log_file
+        description="Path to log file",
+        default=os.environ.get("CONTAINER_MANAGER_LOG_FILE", None),
     ),
     ctx: Context = Field(
         description="MCP context for progress reporting", default=None
     ),
 ) -> Dict:
+    """
+    Leaves the Docker Swarm cluster.
+    Returns: A dictionary confirming the leave action.
+    """
     if manager_type and manager_type != "docker":
         raise ValueError("Swarm operations are only supported on Docker")
     logger = logging.getLogger("ContainerManager")
@@ -1040,18 +1174,24 @@ async def leave_swarm(
 async def list_nodes(
     manager_type: Optional[str] = Field(
         description="Container manager: must be docker for swarm (default: auto-detect)",
-        default=environment_container_manager_type,
+        default=os.environ.get("CONTAINER_MANAGER_TYPE", None),
     ),
     silent: Optional[bool] = Field(
-        description="Suppress output", default=environment_silent
+        description="Suppress output",
+        default=to_boolean(os.environ.get("CONTAINER_MANAGER_SILENT", False)),
     ),
     log_file: Optional[str] = Field(
-        description="Path to log file", default=environment_log_file
+        description="Path to log file",
+        default=os.environ.get("CONTAINER_MANAGER_LOG_FILE", None),
     ),
     ctx: Context = Field(
         description="MCP context for progress reporting", default=None
     ),
 ) -> List[Dict]:
+    """
+    Lists nodes in the Docker Swarm cluster.
+    Returns: A list of dictionaries, each with node details like 'id', 'hostname', 'status', 'role'.
+    """
     if manager_type and manager_type != "docker":
         raise ValueError("Swarm operations are only supported on Docker")
     logger = logging.getLogger("ContainerManager")
@@ -1079,18 +1219,24 @@ async def list_nodes(
 async def list_services(
     manager_type: Optional[str] = Field(
         description="Container manager: must be docker for swarm (default: auto-detect)",
-        default=environment_container_manager_type,
+        default=os.environ.get("CONTAINER_MANAGER_TYPE", None),
     ),
     silent: Optional[bool] = Field(
-        description="Suppress output", default=environment_silent
+        description="Suppress output",
+        default=to_boolean(os.environ.get("CONTAINER_MANAGER_SILENT", False)),
     ),
     log_file: Optional[str] = Field(
-        description="Path to log file", default=environment_log_file
+        description="Path to log file",
+        default=os.environ.get("CONTAINER_MANAGER_LOG_FILE", None),
     ),
     ctx: Context = Field(
         description="MCP context for progress reporting", default=None
     ),
 ) -> List[Dict]:
+    """
+    Lists services in the Docker Swarm.
+    Returns: A list of dictionaries, each with service details like 'id', 'name', 'replicas', 'image'.
+    """
     if manager_type and manager_type != "docker":
         raise ValueError("Swarm operations are only supported on Docker")
     logger = logging.getLogger("ContainerManager")
@@ -1127,18 +1273,24 @@ async def create_service(
     ),
     manager_type: Optional[str] = Field(
         description="Container manager: must be docker for swarm (default: auto-detect)",
-        default=environment_container_manager_type,
+        default=os.environ.get("CONTAINER_MANAGER_TYPE", None),
     ),
     silent: Optional[bool] = Field(
-        description="Suppress output", default=environment_silent
+        description="Suppress output",
+        default=to_boolean(os.environ.get("CONTAINER_MANAGER_SILENT", False)),
     ),
     log_file: Optional[str] = Field(
-        description="Path to log file", default=environment_log_file
+        description="Path to log file",
+        default=os.environ.get("CONTAINER_MANAGER_LOG_FILE", None),
     ),
     ctx: Context = Field(
         description="MCP context for progress reporting", default=None
     ),
 ) -> Dict:
+    """
+    Creates a new service in Docker Swarm.
+    Returns: A dictionary with the created service's ID and details.
+    """
     if manager_type and manager_type != "docker":
         raise ValueError("Swarm operations are only supported on Docker")
     logger = logging.getLogger("ContainerManager")
@@ -1167,18 +1319,24 @@ async def remove_service(
     service_id: str = Field(description="Service ID or name"),
     manager_type: Optional[str] = Field(
         description="Container manager: must be docker for swarm (default: auto-detect)",
-        default=environment_container_manager_type,
+        default=os.environ.get("CONTAINER_MANAGER_TYPE", None),
     ),
     silent: Optional[bool] = Field(
-        description="Suppress output", default=environment_silent
+        description="Suppress output",
+        default=to_boolean(os.environ.get("CONTAINER_MANAGER_SILENT", False)),
     ),
     log_file: Optional[str] = Field(
-        description="Path to log file", default=environment_log_file
+        description="Path to log file",
+        default=os.environ.get("CONTAINER_MANAGER_LOG_FILE", None),
     ),
     ctx: Context = Field(
         description="MCP context for progress reporting", default=None
     ),
 ) -> Dict:
+    """
+    Removes a service from Docker Swarm.
+    Returns: A dictionary confirming the removal.
+    """
     if manager_type and manager_type != "docker":
         raise ValueError("Swarm operations are only supported on Docker")
     logger = logging.getLogger("ContainerManager")
@@ -1209,18 +1367,24 @@ async def compose_up(
     build: bool = Field(description="Build images", default=False),
     manager_type: Optional[str] = Field(
         description="Container manager: docker, podman (default: auto-detect)",
-        default=environment_container_manager_type,
+        default=os.environ.get("CONTAINER_MANAGER_TYPE", None),
     ),
     silent: Optional[bool] = Field(
-        description="Suppress output", default=environment_silent
+        description="Suppress output",
+        default=to_boolean(os.environ.get("CONTAINER_MANAGER_SILENT", False)),
     ),
     log_file: Optional[str] = Field(
-        description="Path to log file", default=environment_log_file
+        description="Path to log file",
+        default=os.environ.get("CONTAINER_MANAGER_LOG_FILE", None),
     ),
     ctx: Context = Field(
         description="MCP context for progress reporting", default=None
     ),
 ) -> str:
+    """
+    Starts services defined in a Docker Compose file.
+    Returns: A string with the output of the compose up command, parse for status messages.
+    """
     logger = logging.getLogger("ContainerManager")
     logger.debug(
         f"Compose up {compose_file} for {manager_type}, silent: {silent}, log_file: {log_file}"
@@ -1247,18 +1411,24 @@ async def compose_down(
     compose_file: str = Field(description="Path to compose file"),
     manager_type: Optional[str] = Field(
         description="Container manager: docker, podman (default: auto-detect)",
-        default=environment_container_manager_type,
+        default=os.environ.get("CONTAINER_MANAGER_TYPE", None),
     ),
     silent: Optional[bool] = Field(
-        description="Suppress output", default=environment_silent
+        description="Suppress output",
+        default=to_boolean(os.environ.get("CONTAINER_MANAGER_SILENT", False)),
     ),
     log_file: Optional[str] = Field(
-        description="Path to log file", default=environment_log_file
+        description="Path to log file",
+        default=os.environ.get("CONTAINER_MANAGER_LOG_FILE", None),
     ),
     ctx: Context = Field(
         description="MCP context for progress reporting", default=None
     ),
 ) -> str:
+    """
+    Stops and removes services from a Docker Compose file.
+    Returns: A string with the output of the compose down command, parse for status messages.
+    """
     logger = logging.getLogger("ContainerManager")
     logger.debug(
         f"Compose down {compose_file} for {manager_type}, silent: {silent}, log_file: {log_file}"
@@ -1285,18 +1455,24 @@ async def compose_ps(
     compose_file: str = Field(description="Path to compose file"),
     manager_type: Optional[str] = Field(
         description="Container manager: docker, podman (default: auto-detect)",
-        default=environment_container_manager_type,
+        default=os.environ.get("CONTAINER_MANAGER_TYPE", None),
     ),
     silent: Optional[bool] = Field(
-        description="Suppress output", default=environment_silent
+        description="Suppress output",
+        default=to_boolean(os.environ.get("CONTAINER_MANAGER_SILENT", False)),
     ),
     log_file: Optional[str] = Field(
-        description="Path to log file", default=environment_log_file
+        description="Path to log file",
+        default=os.environ.get("CONTAINER_MANAGER_LOG_FILE", None),
     ),
     ctx: Context = Field(
         description="MCP context for progress reporting", default=None
     ),
 ) -> str:
+    """
+    Lists containers for a Docker Compose project.
+    Returns: A string in table format listing name, command, state, ports; parse as text table.
+    """
     logger = logging.getLogger("ContainerManager")
     logger.debug(
         f"Compose ps {compose_file} for {manager_type}, silent: {silent}, log_file: {log_file}"
@@ -1324,18 +1500,24 @@ async def compose_logs(
     service: Optional[str] = Field(description="Specific service", default=None),
     manager_type: Optional[str] = Field(
         description="Container manager: docker, podman (default: auto-detect)",
-        default=environment_container_manager_type,
+        default=os.environ.get("CONTAINER_MANAGER_TYPE", None),
     ),
     silent: Optional[bool] = Field(
-        description="Suppress output", default=environment_silent
+        description="Suppress output",
+        default=to_boolean(os.environ.get("CONTAINER_MANAGER_SILENT", False)),
     ),
     log_file: Optional[str] = Field(
-        description="Path to log file", default=environment_log_file
+        description="Path to log file",
+        default=os.environ.get("CONTAINER_MANAGER_LOG_FILE", None),
     ),
     ctx: Context = Field(
         description="MCP context for progress reporting", default=None
     ),
 ) -> str:
+    """
+    Retrieves logs for services in a Docker Compose project.
+    Returns: A string containing combined log output, prefixed by service names; parse as text lines.
+    """
     logger = logging.getLogger("ContainerManager")
     logger.debug(
         f"Compose logs {compose_file} for {manager_type}, silent: {silent}, log_file: {log_file}"
@@ -1375,9 +1557,5 @@ def container_manager_mcp():
         sys.exit(1)
 
 
-def main():
-    container_manager_mcp()
-
-
 if __name__ == "__main__":
     container_manager_mcp()

{container_manager_mcp-1.0.6.dist-info → container_manager_mcp-1.1.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: container-manager-mcp
-Version: 1.0.6
+Version: 1.1.0
 Summary: Container Manager manage Docker, Docker Swarm, and Podman containers as an MCP Server
 Author-email: Audel Rouhi <knucklessg1@gmail.com>
 License: MIT
@@ -48,7 +48,7 @@ Dynamic: license-file
 ![PyPI - Wheel](https://img.shields.io/pypi/wheel/container-manager-mcp)
 ![PyPI - Implementation](https://img.shields.io/pypi/implementation/container-manager-mcp)
 
-*Version: 1.0.6*
+*Version: 1.1.0*
 
 Container Manager MCP Server provides a robust interface to manage Docker and Podman containers, networks, volumes, and Docker Swarm services through a FastMCP server, enabling programmatic and remote container management.
 
@@ -123,8 +123,10 @@ Configure `mcp.json`
         "container-manager-mcp"
       ],
       "env": {
-        "SILENT": "False",                                  //Optional
-        "LOG_FILE": "~/Documents/container_manager_mcp.log" //Optional
+        "CONTAINER_MANAGER_SILENT": "False",                                  //Optional
+        "CONTAINER_MANAGER_LOG_FILE": "~/Documents/container_manager_mcp.log" //Optional
+        "CONTAINER_MANAGER_TYPE": "podman",                                   //Optional
+        "CONTAINER_MANAGER_PODMAN_BASE_URL": "tcp://127.0.0.1:8080"           //Optional
       },
       "timeout": 200000
     }

container_manager_mcp-1.1.0.dist-info/RECORD

@@ -0,0 +1,10 @@
+container_manager_mcp/__init__.py,sha256=2jGc7NMMlaj8-VhO0Z3KpQM50bB_fweiex-hDBfVTWo,540
+container_manager_mcp/__main__.py,sha256=4bpregRyaWJBXOg9_h_F4xcHcX6bPVLL48V2EuwNGBs,168
+container_manager_mcp/container_manager.py,sha256=Rtqrb4H05thq_i7z7v7M33m5rrNZ1V5rYWwV2NC8Zwo,89504
+container_manager_mcp/container_manager_mcp.py,sha256=qeyOZAv7rgOVwjHZuIxb6gBeHvoz8gG9p7dSRDXTvYA,55003
+container_manager_mcp-1.1.0.dist-info/licenses/LICENSE,sha256=Z1xmcrPHBnGCETO_LLQJUeaSNBSnuptcDVTt4kaPUOE,1060
+container_manager_mcp-1.1.0.dist-info/METADATA,sha256=Wgr36FGeQrKP9tWSDnpHMbGgJDsbestwVH506_2SNsY,8452
+container_manager_mcp-1.1.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+container_manager_mcp-1.1.0.dist-info/entry_points.txt,sha256=n7fE9uXdRktmjvZwyaiQkY0Dd7tMN6AKiHav0ZQdE2I,186
+container_manager_mcp-1.1.0.dist-info/top_level.txt,sha256=B7QQLOd9mBdu0lsPKqyu4T8-zUtbqKzQJbMbtAzoozU,22
+container_manager_mcp-1.1.0.dist-info/RECORD,,

container_manager_mcp-1.1.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+container-manager = container_manager_mcp.container_manager:container_manager
+container-manager-mcp = container_manager_mcp.container_manager_mcp:container_manager_mcp

container_manager_mcp-1.0.6.dist-info/RECORD

@@ -1,10 +0,0 @@
-container_manager_mcp/__init__.py,sha256=N3bhKd_oh5YmBBl9N1omfZgaXhJyP0vOzH4VKxs68_g,506
-container_manager_mcp/__main__.py,sha256=zic5tX336HG8LfdzQQ0sDVx-tMSOsgOZCtaxHWgJ4Go,134
-container_manager_mcp/container_manager.py,sha256=O-Dk6q-QSQJbzHVHC3KeljJuGoDdkjlTcaCwC_4hdgo,88877
-container_manager_mcp/container_manager_mcp.py,sha256=E3FOTFILyYYoJF3Erkpl5zapkiDi2pKlJlkZByc-8QE,47361
-container_manager_mcp-1.0.6.dist-info/licenses/LICENSE,sha256=Z1xmcrPHBnGCETO_LLQJUeaSNBSnuptcDVTt4kaPUOE,1060
-container_manager_mcp-1.0.6.dist-info/METADATA,sha256=WygJ6UaeqBGVthdIZvSYbl40n2M40F2aL-toAm2zq8o,8238
-container_manager_mcp-1.0.6.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-container_manager_mcp-1.0.6.dist-info/entry_points.txt,sha256=I23pXcCgAShlfYbENzs3kbw3l1lU9Gy7lODPfRqeeiA,156
-container_manager_mcp-1.0.6.dist-info/top_level.txt,sha256=B7QQLOd9mBdu0lsPKqyu4T8-zUtbqKzQJbMbtAzoozU,22
-container_manager_mcp-1.0.6.dist-info/RECORD,,

container_manager_mcp-1.0.6.dist-info/entry_points.txt

@@ -1,3 +0,0 @@
-[console_scripts]
-container-manager = container_manager_mcp.container_manager:main
-container-manager-mcp = container_manager_mcp.container_manager_mcp:main