Podman MCP Server

Instructions

Implementation Reference

• main_b.py:522-526 (handler)

  The main handler function for the 'container_logs' tool. It extracts container name/ID and optional tail lines from args, runs 'podman logs --tail <n> <container>', and returns the output or error.
  async def container_logs(self, args: Dict[str, Any]) -> Dict[str, Any]: container = args.get("container") tail = args.get("tail", 100) result = run_podman(["logs", "--tail", str(tail), container]) return {"output": result["stdout"] if result["success"] else f"Error: {result['stderr']}"}
• main_b.py:244-262 (schema)

  Input schema definition for the container_logs tool, defining required 'container' string and optional 'tail' integer.
  Tool( name="container_logs", description="Get logs from a container", inputSchema={ "type": "object", "properties": { "container": { "type": "string", "description": "Container name or ID" }, "tail": { "type": "integer", "description": "Number of lines to show from end of log", "default": 100 } }, "required": ["container"] } ),
• main_b.py:459-472 (registration)

  Registration of tool handlers in the handle_tools_call method, mapping 'container_logs' to self.container_logs function.
  tool_handlers = { "list_containers": self.list_containers, "container_info": self.container_info, "start_container": self.start_container, "stop_container": self.stop_container, "restart_container": self.restart_container, "container_logs": self.container_logs, "run_container": self.run_container, "remove_container": self.remove_container, "exec_container": self.exec_container, "list_images": self.list_images, "pull_image": self.pull_image, "container_stats": self.container_stats, }
• main.py:191-197 (handler)

  Alternative handler for 'container_logs' using FastMCP decorator, similar logic running podman logs.
  @mcp.tool(title="Container logs", description="Get logs from a container.") def container_logs( container: str = Field(..., description="Container name or ID"), tail: int = Field(100, description="Number of lines to show from end of log"), ) -> str: result = run_podman(["logs", "--tail", str(tail), container]) return result["stdout"] if result["success"] else f"Error: {result['stderr']}"
• main_b.py:50-72 (helper)

  Helper function used by all tools including container_logs to execute podman commands and return structured results.
  def run_podman(args: List[str]) -> Dict[str, Any]: """Run a podman command and capture output""" try: cmd = ["podman"] + args logger.info(f"Running command: {' '.join(cmd)}") result = subprocess.run( cmd, capture_output=True, text=True, timeout=30 ) return { "success": result.returncode == 0, "stdout": result.stdout.strip(), "stderr": result.stderr.strip(), "returncode": result.returncode, } except subprocess.TimeoutExpired: logger.error("Command timed out") return {"success": False, "stdout": "", "stderr": "Command timed out", "returncode": -1} except Exception as e: logger.error(f"Command error: {e}") return {"success": False, "stdout": "", "stderr": str(e), "returncode": -1}