Ubi-Tel/just-do-it

Just Do IT! 🚀💻

Just Do IT! - The Information Technology orchestrator that actually gets IT done! A blazingly fast MCP server for Docker deployments. No excuses, no delays, just pure IT execution.

What is IT? 🤔

An IT-powered, production-ready MCP server for orchestrating Docker deployments with:

• 🚀 Just Do IT Mentality: Quick timeouts, auto-retry, no IT nonsense
• 🔒 IT Security: Multi-profile permission system that keeps IT secure
• 📦 Docker Orchestration: Complete container lifecycle - IT just works!
• 🔄 Stateless HTTP: Clean, scalable, no session overhead - IT's efficient!
• ⚡ Fast Failure: 10-second SSH timeouts with retry logic - IT fails fast!

Install IT! 💿

pip install just-do-it
# That's IT! You're ready!

Quick Start IT! ⚡

# Just do IT with default settings
just-do-it --config config.json

# Need stdio? Just do IT!
just-do-it --transport stdio

# Custom port? Just do IT!
just-do-it --port 8080

# Development mode with autorestart? Just do IT!
just-do-it --autorestart --port 8000

# Check IT's working!
just-do-it --health-check

The IT Philosophy 🧠

Why wait? Why overthink? This is IT at its finest:

• Deploy containers? Just do IT!
• Check status? Just check IT!
• Sync files? Just sync IT!
• Handle errors? Just handle IT! (with clean error responses)
• Need results? Just get IT done!

"Have you tried turning IT off and on again?" - Not needed, IT just works!

IT Features 🎯

• ⚡ 10-second SSH timeouts - Fail fast, retry once
• 🔄 Automatic retry logic - Try twice, then move on
• 🚫 No session crashes - Errors handled gracefully
• 🏗️ Clean architecture - 5 layers of separation
• 🔐 Profile permissions - Builder vs Deployer roles
• 🔥 Autorestart on file changes - Development mode with automatic restart
  • Watches for Python file changes
  • Properly releases ports before restarting
  • No more "port already in use" errors!

IT Tools (16 and counting!) 🛠️

• Docker: status, up, down, restart, logs, exec, build
• Files: sync_files, copy_env_file, create_anchor
• Remote: make_command, ssh_command
• System: health_check, get_config
• Images: set_compose_images

Configure IT! ⚙️

{
  "ssh_profiles": {
    "builder": {
      "remote_host": "your.server.com",
      "remote_user": "builder",
      "ssh_key": "~/.ssh/id_ed25519",
      "ssh_timeout": 10,
      "capabilities": ["build", "tag", "sync"]
    },
    "deployer": {
      "remote_host": "your.server.com",
      "remote_user": "deployer",
      "ssh_key": "~/.ssh/id_ed25519",
      "ssh_timeout": 10,
      "capabilities": ["deploy", "restart", "logs"]
    }
  }
}

Why "Just Do IT"? 🎯

Because in IT, waiting is downtime! This MCP server:

• Doesn't wait 5 minutes for SSH timeouts - IT's got places to be!
• Doesn't crash on errors - IT handles them gracefully
• Doesn't overthink - IT executes with precision
• Doesn't make excuses - IT retries once and reports
• Works first time? That's IT! Doesn't work? Try IT again!

License 📜

BSD 3-Clause - Just use IT! (See LICENSE file for the full IT details)

Contributing 🤝

Got an IT idea? Just implement IT! Open a PR. Found a bug? Just report IT! Want a feature? Just request IT!

Remember: When in doubt, Just Do IT! 🚀💻

"IT's not a bug, IT's a feature!" - Every IT professional ever

🎉 Fun IT Fact: This project turns "Have you tried...?" into "IT already did!"