POEditor MCP Server

#!/usr/bin/env python3 """ 🎯 Complete POEditor MCP System Demo Demonstrates a typical workflow using the POEditor MCP server """ import asyncio import subprocess import sys from pathlib import Path from datetime import datetime async def run_command(command: str, description: str): """Execute command and show result.""" print(f"\n{'='*60}") print(f"🚀 {description}") print('='*60) print(f"💻 Command: {command}") print() try: # Execute command result = subprocess.run( command.split(), capture_output=True, text=True, timeout=60 ) if result.returncode == 0: print(result.stdout) print("✅ Command executed successfully") else: print("❌ Execution error:") print(result.stderr) except subprocess.TimeoutExpired: print("⏰ Command timed out") except Exception as e: print(f"❌ Error executing command: {e}") # Pause for reading input("\n📖 Press Enter to continue...") async def demo_workflow(): """Demo of complete workflow.""" print("🎯 COMPLETE WORKFLOW DEMO") print("=" * 60) print("This demo simulates a typical day working with POEditor MCP:") print("1. 🌅 Initial setup") print("2. 🔍 Morning monitoring") print("3. 📊 Daily reports") print("4. 🤖 Translation automation") print("5. 📈 Workflow optimization") print("6. 📦 Export for developers") print() response = input("Continue with demo? (y/N): ").lower().strip() if response not in ['y', 'yes']: print("Demo cancelled.") return # Change to scripts directory scripts_dir = Path(__file__).parent print(f"📁 Working directory: {scripts_dir}") # 1. Check MCP server status await run_command( "python -m mcp_poeditor --help", "1. 🔧 MCP Server Status Check" ) # 2. Run basic example await run_command( "python examples/basic_usage.py", "2. 🚨 Basic Usage Example" ) print(f"\n{'='*60}") print("🎉 DEMO COMPLETED!") print('='*60) print("📊 Available directories:") # List available directories output_dirs = ["logs", "reports", "exports", "examples", "docs"] for dir_name in output_dirs: dir_path = scripts_dir / dir_name if dir_path.exists(): files = list(dir_path.glob("*")) if files: print(f"\n📁 {dir_name}/:") for file in files[:3]: # First 3 files if file.is_file(): size = file.stat().st_size / 1024 print(f" 📄 {file.name} ({size:.1f} KB)") print("\n💡 RECOMMENDED NEXT STEPS:") print(" 1. 📧 Configure notifications (SMTP/Slack)") print(" 2. 🕒 Set up automatic scheduling (cron)") print(" 3. 🎯 Customize thresholds for your project") print(" 4. 📱 Integrate exports with your CI/CD") print("\n🔗 USEFUL LINKS:") print(" • 📖 Documentation: docs/INSTALLATION.md") print(" • ⚙️ Configuration: .env.template") print(" • 📊 Examples: examples/") print(" • 🗂️ Logs: logs/") async def demo_api_usage(): """Demo direct MCP API usage.""" print("\n" + "="*60) print("🌐 DIRECT MCP API USAGE DEMO") print("="*60) print("Running some MCP commands directly...") # Use the basic example try: await run_command( "python examples/basic_usage.py", "Running Basic Usage Example" ) except Exception as e: print(f"❌ Error running API demo: {e}") print("💡 Make sure the MCP server is working properly") def show_project_structure(): """Show project structure.""" print("\n" + "="*60) print("📁 POEDITOR MCP PROJECT STRUCTURE") print("="*60) structure = """ poeditor-mcp/ ├── 📄 README.md # Main documentation ├── 📄 requirements.txt # Python dependencies ├── 📄 setup.py # Automated setup script ├── 📄 .env.template # Environment template ├── 📄 LICENSE # MIT License │ ├── 📁 mcp_poeditor/ # Main MCP package │ ├── 📄 __init__.py │ ├── 📄 __main__.py # Entry point │ ├── 📄 server.py # MCP server │ ├── 📄 poeditor_client.py # POEditor API client │ │ │ ├── 📁 tools/ # MCP tools │ │ ├── 📄 projects.py # Project management │ │ ├── 📄 languages.py # Language management │ │ ├── 📄 terms.py # Term management │ │ ├── 📄 translations.py # Translation management │ │ └── 📄 stats.py # Statistics │ │ │ └── 📁 utils/ # Utilities │ ├── 📄 config.py # Configuration │ └── 📄 helpers.py # Helper functions │ ├── 📁 examples/ # 📚 USAGE EXAMPLES │ └── 📄 basic_usage.py # Basic usage example │ ├── 📁 docs/ # 📖 DOCUMENTATION │ └── 📄 INSTALLATION.md # Installation guide │ ├── 📁 scripts/ # 🛠️ AUTOMATION SCRIPTS │ └── 📄 demo_workflow.py # This demo script │ ├── 📁 logs/ # Execution logs (created by setup) ├── 📁 reports/ # Generated reports (created by setup) ├── 📁 exports/ # Mass exports (created by setup) └── 📁 backups/ # Automatic backups (created by setup) """ print(structure) print("🎯 MAIN FEATURES:") print(" • 🔌 Complete MCP server for POEditor") print(" • 🛠️ Full API client with all endpoints") print(" • 📊 Rich tool set for translation management") print(" • 🚨 Professional project structure") print(" • 🤖 Automated setup and configuration") print(" • 📧 Extensible for notifications and automation") print(" • 🕒 Ready for CI/CD integration") print(" • 📦 Professional packaging and documentation") async def main(): """Main demo function.""" print("🎯 COMPLETE DEMO - POEDITOR MCP SYSTEM") print("=" * 60) print("Welcome to the complete POEditor automation system!") print() while True: print("\n🎛️ AVAILABLE OPTIONS:") print(" 1. 📁 View project structure") print(" 2. 🎯 Complete workflow demo") print(" 3. 🌐 Direct MCP API usage demo") print(" 4. 🆘 Help and documentation") print(" 5. 🚪 Exit") choice = input("\n🔢 Select an option (1-5): ").strip() if choice == "1": show_project_structure() elif choice == "2": await demo_workflow() elif choice == "3": await demo_api_usage() elif choice == "4": print("\n📖 HELP AND DOCUMENTATION:") print(" • Main README: README.md") print(" • Installation: docs/INSTALLATION.md") print(" • Basic usage: examples/basic_usage.py") print(" • Configuration: .env.template") print("\n🔧 SETUP:") print(" • Run: python setup.py") print(" • Configure: edit .env file") print(" • Test: python examples/basic_usage.py") elif choice == "5": print("\n👋 Thanks for using POEditor MCP!") print("🌟 Hope you enjoy translation automation") break else: print("❌ Invalid option. Please select 1-5.") if __name__ == "__main__": try: asyncio.run(main()) except KeyboardInterrupt: print("\n\n👋 Demo interrupted. See you later!") except Exception as e: print(f"\n❌ Demo error: {e}") sys.exit(1)