MotherBrainGPT Supabase MCP桥
一个生产就绪的HTTP网桥服务器，通过模型上下文协议（MCP）将CustomGPT（MotherBrainGPT）连接到Supabase，为泰国帕岸岛的椰子海滩酒店和餐厅实现实时数据库操作。
🏗️ 建筑
CustomGPT (MotherBrainGPT) → HTTP REST API → MCP Bridge Server → Supabase MCP Server → PostgreSQL Database- 前端：CustomGPT，以酒店为中心的说明
- 桥：具有JSON-RPC转换的Node.js Express服务器
- 后端：支持MCP服务器进行数据库操作
- 部署：Fly.io与Docker容器化
✅ 特性
🔄 实时数据库访问
- 通过REST API执行SQL查询
- 列出数据库表和架构
- 搜索Supabase文档
- 获取数据库顾问和日志
- 管理边缘功能和分支
🎯 商业智能
- 酒店客人管理和跟踪
- 餐厅菜单和订单管理
- WhatsApp通信分析
- 收入和运营分析
- 宾客体验优化
🛡️ 生产就绪
- 承载令牌身份验证
- 请求/响应捕获系统
- 错误处理和超时
- CORS支持web集成
- 综合录井
🚀 快速开始
先决条件
- Node.js 18+
- 辅助账户和项目
- Fly.io帐户（用于部署）
地方发展
# Clone and install
git clone https://github.com/yourusername/supabase-mcp-fly.git
cd supabase-mcp-fly
npm install
# Set environment variables
export SUPABASE_ACCESS_TOKEN="your-token"
export PROJECT_REF="your-project-ref"
export BRIDGE_TOKEN="your-auth-token"
# Start server
npm start部署到Fly.io
# Set secrets
fly secrets set SUPABASE_ACCESS_TOKEN="your-token"
fly secrets set PROJECT_REF="your-project-ref"
fly secrets set BRIDGE_TOKEN="your-auth-token"
# Deploy
fly deploy📡 API终点
核心工具
GET /api/tools-列出可用的MCP工具POST /api/tools/execute_sql-执行SQL查询POST /api/tools/list_tables-获取数据库架构POST /api/tools/search_docs-搜索Supabase文档
认证
所有端点都需要Bearer令牌：
curl -H "Authorization: Bearer your-auth-token" \
https://your-app.fly.dev/api/tools🤖 CustomGPT集成
配置
- 基本URL:
https://your-app.fly.dev - 认证：承载令牌
- 开放应用程序接口：使用
openapi-customgpt.yaml - 说明：复制自
MOTHERBRAIN_INSTRUCTIONS_SHORT.txt
示例查询
-- Menu items with categories
SELECT p.name, p.description, p.price, c.name as category
FROM products p LEFT JOIN categories c ON p.category_id = c.id
ORDER BY c.sort_order, p.name;
-- Today's orders
SELECT customer_name, total_amount, order_status
FROM orders WHERE DATE(created_at) = CURRENT_DATE;
-- Current guests
SELECT stay_id, first_name, table_number
FROM guests ORDER BY created_at DESC;📊 数据库模式
关键表
- 产品 （65项）-餐厅菜单及价格
- 订单 （4434条记录）-客户订单跟踪
- 宾客 （203活跃）-酒店宾客管理
- whatsapp_logs （1494条消息）-通信日志
- 入住人数 （55个待定）-到货管理
📋 文档
CUSTOMGPT_CONFIGURATION.md-完整的设置指南MOTHERBRAIN_TEST_PROMPTS.md-87个测试场景openapi-customgpt.yaml-定制GPT-optimized API规范motherbrain-test-prompts.csv-结构化测试用例
🛠️ 发展
项目结构
├── server.js # Main bridge server
├── openapi-customgpt.yaml # API specification
├── MOTHERBRAIN_INSTRUCTIONS.md # CustomGPT instructions
├── CUSTOMGPT_CONFIGURATION.md # Setup documentation
├── motherbrain-test-prompts.csv # Test scenarios
└── fly.toml # Deployment config关键组件
- 响应捕获：按ID匹配JSON-RPC请求/响应
- 请求路由：将HTTP REST转换为MCP协议
- 错误处理：全面的错误消息和回退
- 认证：承载令牌验证中间件
🧪 测试
从CSV文件运行测试提示：
# Basic functionality
"List our current menu items"
"Show me today's orders"
"How many guests are currently checked in?"
# Business intelligence
"What are our top 5 most popular menu items?"
"Show me revenue breakdown by category"
"Which guests need follow-up?"🔧 故障排除
常见问题
- “找不到工具” → Use
execute_sql对于所有数据库查询 - “ZodError” → 不要通过
schema参数到list_tables - “MissingKwarsError” → 包含
"arguments": {}在请求正文中 - 身份验证错误 → 检查承载令牌格式
调试模式
集 DEBUG_MCP=1 详细日志记录的环境变量。
🌟 成功指标
- ✅ 零刀具错误 -完美的API集成
- ✅ 实时数据 -实时数据库连接
- ✅ 业务环境 -以酒店为重点的回应
- ✅ 专业输出 -泰铢格式、分类
- ✅ 运营见解 -可操作的商业智能
📈 现场表演
MotherBrainGPT成功为椰子海滩运营提供服务：
- 42个数据库表 可通过自然语言访问
- 菜单管理 实时定价（约20-1200）
- 订单跟踪 具有状态监控功能
- 宾客服务 具有到达/离开管理功能
- 通信分析 通过WhatsApp集成
🤝 贡献
- 复刻仓库
- 创建特征分支(
git checkout -b feature/amazing-feature) - 提交更改(
git commit -m 'Add amazing feature') - 推送到分支(
git push origin feature/amazing-feature) - 打开拉取请求
📄 许可证
此项目根据MIT许可证获得许可-有关详细信息，请参阅许可证文件。
🏖️ 关于椰子海滩
泰国帕岸岛的精品酒店和餐厅，利用人工智能和实时数据提供卓越的酒店体验。
______________________________________________________________________
内置于❤️ 酒店业 🌴🥥