bruvtools 🚀

What is bruvtools?

bruvtools is a CLI tool that turns any cloud server into a private app platform, enabling push-to-deploy microservices written in Node.js, Go, Python, Java, PHP, Ruby, or any containerizable application to CapRover, AWS, GCP, or Kubernetes. It is designed for developers who want a low-cost, self-hosted alternative to Heroku or Vercel with zero vendor lock-in.

How to use bruvtools?

Install globally with npm install -g bruvtools, then run bruvtools init to create bruvtools.yml (configuration) and .env (secrets). Deploy with bruvtools deploy <app-name>. For IDE integration, configure the MCP server in Cursor.com using the provided JSON snippet or the automated setup script.

Key features of bruvtools

• Deploy any language with a single command.
• Automatic SSL certificates on every deployment.
• Zero-downtime rolling updates.
• Auto scaling of app instances.
• Private and secure – your own server.
• Cost effective at ~$5/month.
• Smart collision detection for app names.

Use cases of bruvtools

• Deploy Node.js, Python, Go, or Java microservices to a personal CapRover server.
• Create staging, development, and production environments with multi-environment deployment.
• Manage infrastructure from within Cursor.com using AI‑assisted MCP commands.
• Host side projects, APIs, or full‑stack apps without paying for expensive platforms.

FAQ from bruvtools

What prerequisites are needed to use bruvtools?

You need a server with Docker (minimum 1 GB RAM, 1 CPU), a domain name for wildcard DNS, and Node.js installed. The easiest setup uses DigitalOcean’s one‑click CapRover image with $5/month and $100 free credit for new users.

How does bruvtools compare to Heroku or Vercel?

bruvtools gives you the same push‑to‑deploy, auto‑SSL, and scaling features but runs on your own server, costing ~$5/month vs $25+ on other platforms, with no vendor lock‑in.

Where does my application data and code live?

All application data and code are stored on your own CapRover server (or the cloud provider you configure). No third‑party platform stores your secrets or containers.

What runtime or dependencies does the MCP server require?

The MCP server runs as part of the bruvtools CLI, which requires Node.js (v16+). The deployed apps can use any language or runtime supported by Docker.

How does the MCP server authenticate with my CapRover instance?

Authentication is done via environment variables (CAPROVER_PASSWORD, CAPROVER_DOMAIN, CAPROVER_MACHINE) set in the MCP configuration, or by using the local bruvtools.yml and .env files in your project directory.