devenv-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Paul Lin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,210 @@
+# 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 that lets AI coding assistants provision cloud services and create accounts automatically - 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
+- **Encrypted storage** - All credentials stored locally with AES-256-GCM
+- **Zero context switching** - Everything happens in your terminal
+
+## Supported Services
+
+| Service | Instant (Temp) | Permanent Account | Status |
+|---------|----------------|-------------------|--------|
+| Neon PostgreSQL | ✅ | ✅ | Ready |
+| Vercel | - | 🔄 | Coming soon |
+| Supabase | - | 🔄 | Coming soon |
+
+## Quick Start
+
+### 1. Install
+
+```bash
+bun install
+```
+
+### 2. Configure Claude Code
+
+Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
+
+```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 |
+
+### 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: "you@gmail.com" })
+
+// 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)"
+})
+```
+
+## 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](https://console.cloud.google.com)
+2. Enable Gmail API
+3. Create OAuth 2.0 credentials (Desktop app)
+4. Save to `~/.devenv/gmail-credentials.json`:
+
+```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] Neon PostgreSQL (instant + permanent)
+- [x] Headless browser automation
+- [x] Gmail integration
+- [ ] Vercel deployments
+- [ ] Supabase backend
+- [ ] Stripe test mode
+- [ ] Partner API integrations
+
+## License
+
+MIT