devenv-mcp 0.1.0 → 0.3.0

package/README.md

@@ -4,23 +4,34 @@ Instant infrastructure from your IDE. No dashboards. No copy-pasting tokens. **N
 
 ## What is this?
 
-An MCP (Model Context Protocol) server that lets AI coding assistants provision cloud services and create accounts automatically - all without you ever leaving your terminal.
+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 in seconds, no signup required
-- **Permanent accounts** - Headless browser creates real accounts for you
-- **Auto email verification** - Gmail integration clicks verification links automatically
+- **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
-- **Zero context switching** - Everything happens in your terminal
+- **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 | - | 🔄 | Coming soon |
-| Supabase | - | 🔄 | Coming soon |
+| 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
 
@@ -76,6 +87,32 @@ Claude: [runs CREATE TABLE]
 | `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 |
@@ -121,6 +158,53 @@ devenv_query({
 })
 ```
 
+### 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
 
 ```
@@ -197,13 +281,21 @@ For automatic email verification:
 
 ## Roadmap
 
-- [x] Neon PostgreSQL (instant + permanent)
-- [x] Headless browser automation
-- [x] Gmail integration
-- [ ] Vercel deployments
-- [ ] Supabase backend
-- [ ] Stripe test mode
-- [ ] Partner API integrations
+- [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