DevEnv MCP Server

Instant infrastructure from your IDE. No dashboards. No copy-pasting tokens. Never leave your CLI.

What is this?

An MCP (Model Context Protocol) server with 89 tools that lets AI coding assistants provision cloud services, deploy apps, and manage developer workflows - all without you ever leaving your terminal.

Features

• Instant databases - PostgreSQL, MySQL, SQLite, Redis, MongoDB in seconds
• Multi-platform deploy - Deploy to Vercel or Railway with one command
• Neon OAuth integration - Connect your Neon account for permanent databases that show in your dashboard
• Database branching - Create instant dev/test copies, reset branches, manage connections
• Deployment management - Roll back deployments, promote previews to production, delete old deployments
• Resource cleanup - Auto-expire temporary resources and clean up unused infrastructure
• 6 project templates - Next.js, API, Fullstack, Static, AI App, SaaS Starter
• Encrypted storage - All credentials stored locally with AES-256-GCM
• 7 cloud providers - Neon, Vercel, Supabase, Turso, Upstash, Cloudflare R2, Railway
• AI DevOps - Query optimization, security audits, migration generation

Supported Services

| Service | Instant (Temp) | Permanent Account | Status | |---------|----------------|-------------------|--------| | Neon PostgreSQL | ✅ | ✅ | Ready | | Vercel | ✅ (via CLI) | ✅ (via CLI auth) | Ready | | Railway | ✅ | ✅ | Ready | | Supabase | ✅ | - | Ready | | Turso SQLite | ✅ | - | Ready | | Upstash Redis | ✅ | - | Ready | | Cloudflare R2 | ✅ | - | Ready |

Note: "Permanent Account" via browser automation is experimental and may break if providers change their UI. CLI-based authentication (Vercel, Railway) is more reliable.

Quick Start

1. Install

bun install

2. Configure Claude Code

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "devenv": {
      "command": "bun",
      "args": ["run", "/path/to/devenv-mcp/src/index.ts"]
    }
  }
}

3. Use It

You: "I need a postgres database"

Claude: [provisions instant Neon database]
        "Done! DATABASE_URL added to .env"

You: "Create a users table"

Claude: [runs CREATE TABLE]
        "Table created."

Tools

Setup & Profile

| Tool | Description | |------|-------------| | devenv_setup | Set your email for creating accounts (one-time) | | devenv_status | Show all provisioned services and profile |

Database Provisioning

| Tool | Description | |------|-------------| | devenv_provision | Provision a database (instant or permanent) | | devenv_inject | Inject credentials into .env file | | devenv_query | Run SQL queries directly |

Neon Account Management

| Tool | Description | |------|-------------| | devenv_neon_connect | Connect your Neon account via OAuth or API key | | devenv_neon_status | Check connection status and list projects | | devenv_neon_disconnect | Remove stored Neon credentials | | devenv_neon_branches | List, create, delete, or reset database branches | | devenv_neon_branch_connection | Get connection string for a specific branch | | devenv_neon_delete | Delete a Neon project |

Vercel Deployment Management

| Tool | Description | |------|-------------| | devenv_vercel_deployments | List recent deployments for a project | | devenv_vercel_rollback | Roll back to a previous deployment | | devenv_vercel_promote | Promote a preview deployment to production | | devenv_vercel_delete | Delete a deployment or entire project |

Resource Cleanup

| Tool | Description | |------|-------------| | devenv_cleanup | Clean up expired vault entries and resources |

Email Verification

| Tool | Description | |------|-------------| | devenv_check_verification | Check for verification emails | | devenv_auto_verify | Wait for and auto-click verification links |

Usage Examples

Instant Database (No Account, 72h Expiry)

devenv_provision({
  service: "neon",
  project_name: "my-app",
  permanent: false
})

Permanent Database (Creates Account)

// First time: set your email
devenv_setup({ email: "[email protected]" })

// Then provision with permanent: true
devenv_provision({
  service: "neon",
  project_name: "my-app",
  permanent: true
})

// If email verification needed:
devenv_auto_verify({ service: "neon" })

Run SQL Queries

devenv_query({
  provision_id: "abc-123",
  sql: "CREATE TABLE users (id SERIAL PRIMARY KEY, email TEXT)"
})

Connect Neon Account (Recommended)

// Connect via OAuth - opens browser, you click one button, done
devenv_neon_connect({ method: "oauth" })

// Or connect via API key if you already have one
devenv_neon_connect({ method: "api_key", api_key: "neon_api_..." })

// Now databases show in your Neon dashboard
devenv_provision({
  service: "neon",
  project_name: "my-app"
})

Database Branching

// Create a dev branch from main
devenv_neon_branches({
  action: "create",
  project_id: "project-123",
  branch_name: "feature-dev"
})

// Reset branch to match main
devenv_neon_branches({
  action: "reset",
  project_id: "project-123",
  branch_id: "br_abc123"
})

Deployment Rollback

// List recent deployments
devenv_vercel_deployments({ project_path: "./my-app" })

// Roll back to previous deployment
devenv_vercel_rollback({
  project_path: "./my-app",
  deployment_url: "https://my-app-abc123.vercel.app"
})

How It Works

┌─────────────────────────────────────────────────┐
│              Your Terminal (Claude Code)         │
└─────────────────────┬───────────────────────────┘
                      │
┌─────────────────────▼───────────────────────────┐
│              DevEnv MCP Server                   │
├─────────────────────────────────────────────────┤
│  Tools: provision, query, inject, verify...     │
└─────────────────────┬───────────────────────────┘
                      │
        ┌─────────────┼─────────────┐
        ▼             ▼             ▼
┌───────────┐  ┌───────────┐  ┌───────────┐
│   Neon    │  │  Browser  │  │   Gmail   │
│  Instant  │  │ Automation│  │    API    │
│    API    │  │(Playwright)│  │           │
└───────────┘  └───────────┘  └───────────┘
        │             │             │
        └─────────────┼─────────────┘
                      ▼
            ┌─────────────────┐
            │  Encrypted Vault │
            │  ~/.devenv/      │
            └─────────────────┘

Gmail Setup (Optional)

For automatic email verification:

1. Create OAuth app at Google Cloud Console
2. Enable Gmail API
3. Create OAuth 2.0 credentials (Desktop app)
4. Save to ~/.devenv/gmail-credentials.json:

{
  "client_id": "YOUR_CLIENT_ID",
  "client_secret": "YOUR_CLIENT_SECRET",
  "redirect_uri": "http://localhost:3456/callback"
}

Security

• Vault & Profile: Encrypted with AES-256-GCM (connection strings, API keys, user data)
• Encryption key: Stored at ~/.devenv/.key with restricted permissions (mode 0600)
• Browser sessions: Stored locally for automation (not encrypted, isolated per service)
• Network: Credentials only sent to respective service providers (Neon, Vercel, etc.)
• Passwords: Generated using crypto.randomBytes (cryptographically secure)

Note: Browser session data (~/.devenv/browser-data/) contains auth cookies for automated provisioning. Protect your ~/.devenv directory as you would ~/.ssh.

File Structure

~/.devenv/
├── vault.json          # Encrypted credentials (AES-256-GCM)
├── profile.json        # Encrypted user profile (AES-256-GCM)
├── .key                # Encryption key (mode 0600)
├── gmail-credentials.json  # Gmail OAuth (optional)
├── browser-data/       # Browser sessions (unencrypted, per-service isolation)
└── screenshots/        # Debug screenshots

Requirements

• Bun or Node.js 18+
• npm/npx (for neondb CLI)
• Chromium (installed automatically by Playwright)

Roadmap

• [x] Phase 1: Core Infrastructure (Neon, encrypted vault)
• [x] Phase 2: Developer Workflow (dev servers, testing, linting)
• [x] Phase 3: Project Scaffolding (6 templates)
• [x] Phase 4: Observability (health checks, cost tracking)
• [x] Phase 5: AI DevOps (query optimization, security audits)
• [x] Phase 6: Multi-platform Deploy (Vercel, Railway)
• [x] Phase 7: Telemetry & Analytics
• [ ] Phase 8: Plugin system for custom providers
• [ ] Phase 9: Team collaboration features

Telemetry

DevEnv collects anonymous usage data to help improve the product. No personal information is collected.

Opt out: Set DEVENV_TELEMETRY_DISABLED=1 or DO_NOT_TRACK=1

License

MIT