pomera-ai-commander 1.1.1 → 1.2.2

package/pomera_mcp_server.py

@@ -1,144 +1,183 @@
-#!/usr/bin/env python3
-"""
-Pomera MCP Server - Exposes Pomera text tools via Model Context Protocol
-
-This is a standalone MCP server that exposes Pomera's text manipulation tools
-to external AI assistants like Claude Desktop, Cursor, and other MCP clients.
-
-Usage:
-    python pomera_mcp_server.py
-
-Configuration for Claude Desktop (claude_desktop_config.json):
-    {
-        "mcpServers": {
-            "pomera": {
-                "command": "python",
-                "args": ["C:/path/to/Pomera-AI-Commander/pomera_mcp_server.py"]
-            }
-        }
-    }
-
-Configuration for Cursor (.cursor/mcp.json):
-    {
-        "mcpServers": {
-            "pomera": {
-                "command": "python",
-                "args": ["C:/path/to/Pomera-AI-Commander/pomera_mcp_server.py"]
-            }
-        }
-    }
-
-Available Tools:
-    - pomera_case_transform: Transform text case (sentence, lower, upper, title)
-    - pomera_base64: Encode/decode Base64
-    - pomera_hash: Generate MD5, SHA-1, SHA-256, SHA-512, CRC32 hashes
-
-Author: Pomera AI Commander
-License: MIT
-"""
-
-import sys
-import os
-import logging
-import argparse
-
-# Add project root to path for imports
-PROJECT_ROOT = os.path.dirname(os.path.abspath(__file__))
-if PROJECT_ROOT not in sys.path:
-    sys.path.insert(0, PROJECT_ROOT)
-
-# Configure logging to stderr (stdout is used for MCP communication)
-logging.basicConfig(
-    level=logging.INFO,
-    format='%(asctime)s - %(name)s - %(levelname)s - %(message)s',
-    stream=sys.stderr
-)
-logger = logging.getLogger(__name__)
-
-
-def main():
-    """Main entry point for the Pomera MCP server."""
-    parser = argparse.ArgumentParser(
-        description="Pomera MCP Server - Expose text tools via Model Context Protocol"
-    )
-    parser.add_argument(
-        "--debug",
-        action="store_true",
-        help="Enable debug logging"
-    )
-    parser.add_argument(
-        "--version",
-        action="version",
-        version="pomera-mcp-server 1.1.1"
-    )
-    parser.add_argument(
-        "--list-tools",
-        action="store_true",
-        help="List available tools and exit"
-    )
-    
-    args = parser.parse_args()
-    
-    if args.debug:
-        logging.getLogger().setLevel(logging.DEBUG)
-        logger.debug("Debug logging enabled")
-    
-    # Import MCP modules
-    try:
-        from core.mcp.tool_registry import ToolRegistry
-        from core.mcp.server_stdio import StdioMCPServer
-    except ImportError as e:
-        logger.error(f"Failed to import MCP modules: {e}")
-        logger.error("Make sure you're running from the Pomera-AI-Commander directory")
-        sys.exit(1)
-    
-    # Create tool registry
-    try:
-        registry = ToolRegistry()
-        logger.info(f"Loaded {len(registry)} tools")
-    except Exception as e:
-        logger.error(f"Failed to create tool registry: {e}")
-        sys.exit(1)
-    
-    # List tools mode
-    if args.list_tools:
-        print("Available Pomera MCP Tools:")
-        print("-" * 60)
-        for tool in registry.list_tools():
-            print(f"\n{tool.name}")
-            print(f"  {tool.description}")
-            if "properties" in tool.inputSchema:
-                print("  Parameters:")
-                for prop_name, prop_def in tool.inputSchema["properties"].items():
-                    prop_type = prop_def.get("type", "any")
-                    prop_desc = prop_def.get("description", "")
-                    required = prop_name in tool.inputSchema.get("required", [])
-                    req_marker = "*" if required else ""
-                    print(f"    - {prop_name}{req_marker} ({prop_type}): {prop_desc}")
-        return
-    
-    # Create and run server
-    server = StdioMCPServer(
-        tool_registry=registry,
-        server_name="pomera-mcp-server",
-        server_version="1.1.1"
-    )
-    
-    logger.info("Starting Pomera MCP Server...")
-    logger.info(f"Available tools: {', '.join(registry.get_tool_names())}")
-    
-    try:
-        # Run synchronously (simpler for stdio)
-        server.run_sync()
-    except KeyboardInterrupt:
-        logger.info("Server interrupted by user")
-    except Exception as e:
-        logger.exception(f"Server error: {e}")
-        sys.exit(1)
-    
-    logger.info("Server shutdown complete")
-
-
-if __name__ == "__main__":
-    main()
-
+#!/usr/bin/env python3
+"""
+Pomera MCP Server - Exposes Pomera text tools via Model Context Protocol
+
+This is a standalone MCP server that exposes Pomera's text manipulation tools
+to external AI assistants like Claude Desktop, Cursor, and other MCP clients.
+
+Usage:
+    python pomera_mcp_server.py
+
+Configuration for Claude Desktop (claude_desktop_config.json):
+    {
+        "mcpServers": {
+            "pomera": {
+                "command": "python",
+                "args": ["C:/path/to/Pomera-AI-Commander/pomera_mcp_server.py"]
+            }
+        }
+    }
+
+Configuration for Cursor (.cursor/mcp.json):
+    {
+        "mcpServers": {
+            "pomera": {
+                "command": "python",
+                "args": ["C:/path/to/Pomera-AI-Commander/pomera_mcp_server.py"]
+            }
+        }
+    }
+
+Available Tools:
+    - pomera_case_transform: Transform text case (sentence, lower, upper, title)
+    - pomera_base64: Encode/decode Base64
+    - pomera_hash: Generate MD5, SHA-1, SHA-256, SHA-512, CRC32 hashes
+
+Author: Pomera AI Commander
+License: MIT
+"""
+
+import sys
+import os
+import json
+import logging
+import argparse
+
+# Add project root to path for imports
+PROJECT_ROOT = os.path.dirname(os.path.abspath(__file__))
+if PROJECT_ROOT not in sys.path:
+    sys.path.insert(0, PROJECT_ROOT)
+
+# Configure logging to stderr (stdout is used for MCP communication)
+logging.basicConfig(
+    level=logging.INFO,
+    format='%(asctime)s - %(name)s - %(levelname)s - %(message)s',
+    stream=sys.stderr
+)
+logger = logging.getLogger(__name__)
+
+
+def main():
+    """Main entry point for the Pomera MCP server."""
+    parser = argparse.ArgumentParser(
+        description="Pomera MCP Server - Expose text tools via Model Context Protocol"
+    )
+    parser.add_argument(
+        "--debug",
+        action="store_true",
+        help="Enable debug logging"
+    )
+    parser.add_argument(
+        "--version",
+        action="version",
+        version="pomera-mcp-server 1.2.2"
+    )
+    parser.add_argument(
+        "--list-tools",
+        action="store_true",
+        help="List available tools and exit"
+    )
+    parser.add_argument(
+        "--call",
+        metavar="TOOL_NAME",
+        help="Call a tool directly and exit (bypasses MCP protocol)"
+    )
+    parser.add_argument(
+        "--args",
+        metavar="JSON",
+        default="{}",
+        help="JSON arguments for --call (default: {})"
+    )
+    
+    args = parser.parse_args()
+    
+    if args.debug:
+        logging.getLogger().setLevel(logging.DEBUG)
+        logger.debug("Debug logging enabled")
+    
+    # Import MCP modules
+    try:
+        from core.mcp.tool_registry import ToolRegistry
+        from core.mcp.server_stdio import StdioMCPServer
+    except ImportError as e:
+        logger.error(f"Failed to import MCP modules: {e}")
+        logger.error("Make sure you're running from the Pomera-AI-Commander directory")
+        sys.exit(1)
+    
+    # Create tool registry
+    try:
+        registry = ToolRegistry()
+        logger.info(f"Loaded {len(registry)} tools")
+    except Exception as e:
+        logger.error(f"Failed to create tool registry: {e}")
+        sys.exit(1)
+    
+    # List tools mode
+    if args.list_tools:
+        print("Available Pomera MCP Tools:")
+        print("-" * 60)
+        for tool in registry.list_tools():
+            print(f"\n{tool.name}")
+            print(f"  {tool.description}")
+            if "properties" in tool.inputSchema:
+                print("  Parameters:")
+                for prop_name, prop_def in tool.inputSchema["properties"].items():
+                    prop_type = prop_def.get("type", "any")
+                    prop_desc = prop_def.get("description", "")
+                    required = prop_name in tool.inputSchema.get("required", [])
+                    req_marker = "*" if required else ""
+                    print(f"    - {prop_name}{req_marker} ({prop_type}): {prop_desc}")
+        return
+    
+    # One-shot call mode
+    if args.call:
+        try:
+            tool_args = json.loads(args.args)
+        except json.JSONDecodeError as e:
+            print(f"Error: Invalid JSON in --args: {e}", file=sys.stderr)
+            sys.exit(1)
+        
+        if args.call not in registry:
+            print(f"Error: Unknown tool '{args.call}'", file=sys.stderr)
+            print(f"Available tools: {', '.join(registry.get_tool_names())}", file=sys.stderr)
+            sys.exit(1)
+        
+        try:
+            result = registry.execute(args.call, tool_args)
+            output = result.to_dict()
+            # For simple text results, just print the text
+            if len(output.get('content', [])) == 1 and output['content'][0].get('type') == 'text':
+                print(output['content'][0]['text'])
+            else:
+                print(json.dumps(output, indent=2, ensure_ascii=False))
+            sys.exit(1 if result.isError else 0)
+        except Exception as e:
+            print(f"Error executing tool: {e}", file=sys.stderr)
+            sys.exit(1)
+        return
+    
+    # Create and run server
+    server = StdioMCPServer(
+        tool_registry=registry,
+        server_name="pomera-mcp-server",
+        server_version="1.2.2"
+    )
+    
+    logger.info("Starting Pomera MCP Server...")
+    logger.info(f"Available tools: {', '.join(registry.get_tool_names())}")
+    
+    try:
+        # Run synchronously (simpler for stdio)
+        server.run_sync()
+    except KeyboardInterrupt:
+        logger.info("Server interrupted by user")
+    except Exception as e:
+        logger.exception(f"Server error: {e}")
+        sys.exit(1)
+    
+    logger.info("Server shutdown complete")
+
+
+if __name__ == "__main__":
+    main()
+

package/requirements.txt

@@ -0,0 +1,33 @@
+# Core dependencies for Pomera AI Commander
+requests>=2.25.0
+reportlab>=3.6.0
+python-docx>=0.8.11
+aiohttp>=3.9.0
+platformdirs>=4.0.0
+
+# AI Tools dependencies
+huggingface-hub>=0.16.0
+google-auth>=2.23.0
+google-auth-oauthlib>=1.1.0
+google-auth-httplib2>=0.1.1
+
+# Google AI SDK (recommended for better error handling and streaming)
+google-genai>=1.0.0
+
+# Azure AI SDK (recommended - Microsoft recommends migrating to this)
+azure-ai-inference>=1.0.0b1
+azure-core>=1.30.0
+
+# Retry logic with exponential backoff
+tenacity>=8.2.0
+
+# Optional audio dependencies (for advanced features)
+# Uncomment if you need audio processing capabilities
+# pyaudio>=0.2.11
+# numpy>=1.21.0
+
+# Performance monitoring (optional)
+# psutil>=5.8.0
+
+# Development and build tools
+pyinstaller>=5.0.0

package/scripts/Dockerfile.alpine

@@ -0,0 +1,43 @@
+# Alpine Linux build - creates smaller, more portable executables
+FROM python:3.11-alpine
+
+# Install build dependencies
+RUN apk add --no-cache \
+    gcc \
+    musl-dev \
+    libffi-dev \
+    g++ \
+    make
+
+# Set working directory
+WORKDIR /app
+
+# Copy requirements and install dependencies
+COPY requirements.txt .
+RUN pip install --no-cache-dir -r requirements.txt
+
+# Install additional AI SDK dependencies (may fail gracefully)
+RUN pip install --no-cache-dir google-genai>=1.0.0 || echo "google-genai installation skipped"
+RUN pip install --no-cache-dir azure-ai-inference>=1.0.0b1 azure-core>=1.30.0 || echo "azure-ai-inference installation skipped"
+RUN pip install --no-cache-dir tenacity>=8.2.0 || echo "tenacity installation skipped"
+RUN pip install --no-cache-dir aiohttp>=3.9.0 || echo "aiohttp installation skipped"
+
+# Copy source code
+COPY . .
+
+# Build static executable with enhanced options
+RUN pyinstaller \
+    --onefile \
+    --name pomera-linux-alpine \
+    --strip \
+    --noupx \
+    --clean \
+    --noconfirm \
+    pomera.py
+
+# Copy to output
+RUN mkdir -p /output && \
+    cp dist/pomera-linux-alpine /output/ && \
+    chmod +x /output/pomera-linux-alpine
+
+CMD ["cp", "/output/pomera-linux-alpine", "/output/"]

package/scripts/Dockerfile.gui-test

@@ -0,0 +1,54 @@
+# Lightweight Linux GUI for testing executables
+FROM ubuntu:22.04
+
+ENV DEBIAN_FRONTEND=noninteractive
+
+# Install minimal GUI and VNC
+RUN apt-get update && apt-get install -y \
+    xfce4-session \
+    xfce4-panel \
+    xfce4-terminal \
+    xfwm4 \
+    thunar \
+    tightvncserver \
+    novnc \
+    websockify \
+    python3 \
+    python3-tk \
+    file \
+    && apt-get clean
+
+# Create test user
+RUN useradd -m -s /bin/bash tester
+RUN echo 'tester:test123' | chpasswd
+
+# Setup VNC for tester
+USER tester
+WORKDIR /home/tester
+
+RUN mkdir -p ~/.vnc
+RUN echo 'test123' | vncpasswd -f > ~/.vnc/passwd
+RUN chmod 600 ~/.vnc/passwd
+
+# VNC startup script
+RUN echo '#!/bin/bash' > ~/.vnc/xstartup && \
+    echo 'export XKL_XMODMAP_DISABLE=1' >> ~/.vnc/xstartup && \
+    echo 'unset SESSION_MANAGER' >> ~/.vnc/xstartup && \
+    echo 'unset DBUS_SESSION_BUS_ADDRESS' >> ~/.vnc/xstartup && \
+    echo 'startxfce4 &' >> ~/.vnc/xstartup && \
+    chmod +x ~/.vnc/xstartup
+
+# Create app directory
+RUN mkdir -p ~/app
+
+USER root
+
+# Start script
+RUN echo '#!/bin/bash' > /start.sh && \
+    echo 'su - tester -c "vncserver :1 -geometry 1280x720 -depth 24"' >> /start.sh && \
+    echo 'websockify --web=/usr/share/novnc/ 6080 localhost:5901' >> /start.sh && \
+    chmod +x /start.sh
+
+EXPOSE 6080
+
+CMD ["/start.sh"]

package/scripts/Dockerfile.linux

@@ -0,0 +1,43 @@
+# Dockerfile for building Linux executables
+FROM python:3.11-slim
+
+# Install system dependencies
+RUN apt-get update && apt-get install -y \
+    gcc \
+    g++ \
+    libc6-dev \
+    libffi-dev \
+    && rm -rf /var/lib/apt/lists/*
+
+# Set working directory
+WORKDIR /app
+
+# Copy requirements first for better caching
+COPY requirements.txt .
+
+# Install Python dependencies
+RUN pip install --no-cache-dir -r requirements.txt
+
+# Install additional AI SDK dependencies (may fail gracefully)
+RUN pip install --no-cache-dir google-genai>=1.0.0 || echo "google-genai installation skipped"
+RUN pip install --no-cache-dir azure-ai-inference>=1.0.0b1 azure-core>=1.30.0 || echo "azure-ai-inference installation skipped"
+RUN pip install --no-cache-dir tenacity>=8.2.0 || echo "tenacity installation skipped"
+RUN pip install --no-cache-dir aiohttp>=3.9.0 || echo "aiohttp installation skipped"
+
+# Copy source code
+COPY . .
+
+# Build the executable
+RUN pyinstaller --onefile --name pomera-linux pomera.py
+
+# Create output directory
+RUN mkdir -p /output
+
+# Copy executable to output
+RUN cp dist/pomera-linux /output/
+
+# Set executable permissions
+RUN chmod +x /output/pomera-linux
+
+# Default command
+CMD ["cp", "/output/pomera-linux", "/host-output/"]

package/scripts/Dockerfile.test-linux

@@ -0,0 +1,80 @@
+# Dockerfile for testing Linux executable with GUI
+FROM ubuntu:22.04
+
+# Avoid interactive prompts during package installation
+ENV DEBIAN_FRONTEND=noninteractive
+
+# Install minimal desktop environment and VNC server
+RUN apt-get update && apt-get install -y \
+    xfce4 \
+    xfce4-goodies \
+    tightvncserver \
+    novnc \
+    websockify \
+    supervisor \
+    dbus-x11 \
+    firefox \
+    xterm \
+    nano \
+    wget \
+    curl \
+    python3 \
+    python3-tk \
+    && apt-get clean \
+    && rm -rf /var/lib/apt/lists/*
+
+# Create a user for VNC
+RUN useradd -m -s /bin/bash testuser
+RUN echo 'testuser:password' | chpasswd
+
+# Set up VNC for the user
+USER testuser
+WORKDIR /home/testuser
+
+# Set VNC password
+RUN mkdir -p ~/.vnc
+RUN echo 'password' | vncpasswd -f > ~/.vnc/passwd
+RUN chmod 600 ~/.vnc/passwd
+
+# Create VNC startup script
+RUN echo '#!/bin/bash' > ~/.vnc/xstartup
+RUN echo 'xrdb $HOME/.Xresources' >> ~/.vnc/xstartup
+RUN echo 'startxfce4 &' >> ~/.vnc/xstartup
+RUN chmod +x ~/.vnc/xstartup
+
+# Switch back to root for supervisor setup
+USER root
+
+# Create supervisor configuration
+RUN mkdir -p /var/log/supervisor
+COPY <<EOF /etc/supervisor/conf.d/supervisord.conf
+[supervisord]
+nodaemon=true
+user=root
+
+[program:vnc]
+command=/usr/bin/vncserver :1 -geometry 1024x768 -depth 24
+user=testuser
+autostart=true
+autorestart=true
+stdout_logfile=/var/log/supervisor/vnc.log
+stderr_logfile=/var/log/supervisor/vnc.log
+
+[program:novnc]
+command=/usr/share/novnc/utils/launch.sh --vnc localhost:5901 --listen 6080
+user=testuser
+autostart=true
+autorestart=true
+stdout_logfile=/var/log/supervisor/novnc.log
+stderr_logfile=/var/log/supervisor/novnc.log
+EOF
+
+# Create directory for the executable
+RUN mkdir -p /home/testuser/app
+RUN chown testuser:testuser /home/testuser/app
+
+# Expose VNC and noVNC ports
+EXPOSE 5901 6080
+
+# Start supervisor
+CMD ["/usr/bin/supervisord", "-c", "/etc/supervisor/conf.d/supervisord.conf"]

package/scripts/Dockerfile.ubuntu

@@ -0,0 +1,39 @@
+# Ubuntu build - good compatibility with most Linux systems
+FROM ubuntu:22.04
+
+# Install Python and build dependencies
+RUN apt-get update && apt-get install -y \
+    python3 \
+    python3-pip \
+    python3-dev \
+    gcc \
+    g++ \
+    libc6-dev \
+    libffi-dev \
+    && rm -rf /var/lib/apt/lists/*
+
+# Set working directory
+WORKDIR /app
+
+# Copy requirements and install dependencies
+COPY requirements.txt .
+RUN pip3 install --no-cache-dir -r requirements.txt
+
+# Install additional AI SDK dependencies (may fail gracefully)
+RUN pip3 install --no-cache-dir google-genai>=1.0.0 || echo "google-genai installation skipped"
+RUN pip3 install --no-cache-dir azure-ai-inference>=1.0.0b1 azure-core>=1.30.0 || echo "azure-ai-inference installation skipped"
+RUN pip3 install --no-cache-dir tenacity>=8.2.0 || echo "tenacity installation skipped"
+RUN pip3 install --no-cache-dir aiohttp>=3.9.0 || echo "aiohttp installation skipped"
+
+# Copy source code
+COPY . .
+
+# Build executable
+RUN pyinstaller --onefile --name pomera-linux-ubuntu pomera.py
+
+# Copy to output
+RUN mkdir -p /output && \
+    cp dist/pomera-linux-ubuntu /output/ && \
+    chmod +x /output/pomera-linux-ubuntu
+
+CMD ["cp", "/output/pomera-linux-ubuntu", "/output/"]

package/scripts/README.md

@@ -0,0 +1,53 @@
+# Build Scripts and Tools
+
+This directory contains all build scripts, Docker files, and build-related tools for Pomera AI Commander.
+
+## Build Scripts
+
+### Local Builds
+- `build.bat` / `build.sh` - Standard local build (onedir)
+- `build-optimized.bat` - Optimized build with maximum size reduction
+- `build-all.bat` - Interactive menu for all build types
+
+### Docker Builds
+- `build-docker.bat` / `build-docker.sh` - Simple Docker Linux build
+- `docker-compose.yml` - Multi-variant Docker builds
+
+## Docker Files
+- `Dockerfile.linux` - Basic Linux build (Python slim)
+- `Dockerfile.ubuntu` - Ubuntu-based build (high compatibility)
+- `Dockerfile.alpine` - Alpine-based build (smaller size)
+
+## Configuration Files
+- `requirements-minimal.txt` - Minimal dependencies for optimized builds
+
+## Testing and Validation
+- `validate-release-workflow.py` - Release workflow validation script
+- `test-linux-simple.bat` - Simple Linux testing script
+
+## Usage
+
+### Quick Start
+```bash
+# Windows - Standard build
+scripts\build.bat
+
+# Windows - Optimized build
+scripts\build-optimized.bat
+
+# Linux/macOS - Standard build
+chmod +x scripts/build.sh
+./scripts/build.sh
+
+# Docker build (any platform)
+./scripts/build-docker.sh
+```
+
+### Docker Multi-Platform
+```bash
+cd scripts
+docker-compose up build-ubuntu    # Ubuntu variant
+docker-compose up build-alpine    # Alpine variant
+```
+
+See the main [BUILD.md](../BUILD.md) for detailed documentation.