pomera-ai-commander 0.1.0 → 1.2.1

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 0.1.0"
-    )
-    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="0.1.0"
-    )
-    
-    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.1.1"
+    )
+    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.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()
+

package/requirements.txt

@@ -0,0 +1,32 @@
+# Core dependencies for Pomera AI Commander
+requests>=2.25.0
+reportlab>=3.6.0
+python-docx>=0.8.11
+aiohttp>=3.9.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/tools/__init__.py

@@ -1,5 +1,5 @@
-"""
-Tools package for Pomera AI Commander
-
-This package contains all the tool modules for the application.
+"""
+Tools package for Pomera AI Commander
+
+This package contains all the tool modules for the application.
 """