mirror of
https://github.com/garrytan/gbrain.git
synced 2026-07-30 11:22:34 +00:00
91ced664b6
* chore: remove Supabase Edge Function MCP deployment The Edge Function never worked reliably. All MCP traffic goes through self-hosted server + ngrok tunnel. Removes deploy-remote.sh, edge-entry.ts, supabase/functions/, .env.production.example, and CHATGPT.md (OAuth not implemented). Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> * docs: rewrite MCP docs for self-hosted + ngrok deployment All per-client guides updated from Edge Function URLs to self-hosted server + ngrok tunnel pattern. DEPLOY.md rewritten with local vs remote paths. ALTERNATIVES.md now shows self-hosted as primary, with ngrok, Tailscale, and Fly.io/Railway comparison. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> * feat: voice recipe v0.8.0 — 25 production patterns from real deployment Identity separation, pre-computed bid system, conversation timing fix, proactive advisor mode, radical prompt compression, OpenAI Realtime Prompting Guide structure, auth-before-speech, brain escalation, stuck watchdog, never-hang-up rule, thinking sounds, fallback TwiML, tool set architecture, trusted user auth, caller routing, dynamic VAD, on-screen debug UI, live moment capture, belt-and-suspenders post-call, mandatory 3-step post-call, WebRTC parity, dual API events, report-aware query routing. WebRTC pseudocode updated with native FormData and 6 gotchas. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> * feat: post-upgrade feature discovery framework upgrade.ts captures old version before upgrading, then execs gbrain post-upgrade (new binary) to read migration files and print feature pitches. Migration files get YAML frontmatter with feature_pitch field (headline, description, recipe, tiers). CLI prints excited builder tone post-upgrade. v0.8.0 migration offers voice setup with environment detection (server vs local) and 3-tier progressive disclosure. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> * feat: add Voice section to README with WebRTC screenshot + tweet link Her out of the box: voice-to-brain with 25 production patterns. WebRTC client screenshot embedded. Remote MCP section rewritten for self-hosted + ngrok. Setup block genericized. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> * test: add recipe validation tests + genericize personal refs 5 new integration tests: secrets completeness, semver version, requires resolution, all-recipes-parse, no-personal-references. Test fixture genericized. CLAUDE.md/TODOS.md/SKILLPACK updated for v0.8.0. build:edge script removed from package.json. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> * chore: bump version and changelog (v0.8.0) Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
65 lines
1.9 KiB
Markdown
65 lines
1.9 KiB
Markdown
# Remote MCP Deployment Options
|
|
|
|
GBrain's MCP server runs via `gbrain serve` (stdio transport). To make it
|
|
accessible from other devices and AI clients, you need an HTTP wrapper and
|
|
a public tunnel. Here are your options.
|
|
|
|
## ngrok (recommended)
|
|
|
|
[ngrok](https://ngrok.com) provides instant public tunnels. The Hobby tier
|
|
($8/mo) gives you a fixed domain that never changes.
|
|
|
|
```bash
|
|
# 1. Install ngrok
|
|
brew install ngrok
|
|
|
|
# 2. Start your MCP server (behind an HTTP wrapper)
|
|
# See docs/mcp/DEPLOY.md for the server setup
|
|
|
|
# 3. Expose via ngrok
|
|
ngrok http 8787 --url your-brain.ngrok.app
|
|
```
|
|
|
|
See the [ngrok-tunnel recipe](../../recipes/ngrok-tunnel.md) for full setup
|
|
including auth token configuration and fixed domain setup.
|
|
|
|
## Tailscale Funnel
|
|
|
|
[Tailscale Funnel](https://tailscale.com/kb/1223/tailscale-funnel) gives you
|
|
a permanent public HTTPS URL with automatic TLS. Free tier available. Best for
|
|
private networks where you control both endpoints.
|
|
|
|
```bash
|
|
# 1. Install Tailscale
|
|
brew install tailscale
|
|
|
|
# 2. Expose your MCP server
|
|
tailscale funnel 8787
|
|
# Your brain is now at https://your-machine.ts.net
|
|
```
|
|
|
|
## Fly.io / Railway (always-on)
|
|
|
|
For production deployments that need to run 24/7 without your machine:
|
|
|
|
- **Fly.io:** $5-10/mo, global edge, `fly deploy`
|
|
- **Railway:** $5/mo, git push deploy
|
|
|
|
Both run Bun natively. No bundling, no Deno, no cold start, no timeout limits.
|
|
|
|
## Comparison
|
|
|
|
| | ngrok | Tailscale | Fly.io/Railway |
|
|
|--|---|---|---|
|
|
| Cost | $8/mo (Hobby) | Free | $5-10/mo |
|
|
| Fixed URL | Yes (Hobby) | Yes | Yes |
|
|
| Works when laptop is off | No | No | Yes |
|
|
| Cold start | None | None | None |
|
|
| Timeout limits | None | None | None |
|
|
| All 30 operations | Yes | Yes | Yes |
|
|
| Setup time | 5 min | 10 min | 15 min |
|
|
|
|
**Note:** `gbrain serve --http` (built-in HTTP transport) is planned but not yet
|
|
implemented. Currently, remote MCP requires a custom HTTP wrapper around `gbrain serve`.
|
|
See [DEPLOY.md](DEPLOY.md) for details.
|