AI导哈

AI代理管理平台

基于Next.js构建的AI代理管理平台，支持MCP配置、用户认证和现代UI设计，适用于AI代理的开发与管理。

  • by marouanemkm
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 marouanemkm/mcp-sandbox

使用说明

MCP沙箱

使用Next.js构建的AI代理平台，具有新野兽派设计系统和安全身份验证功能。该项目为创建和管理具有MCP（模型上下文协议）配置的AI代理提供了基础。

🎯 项目目标

MCP Sandbox旨在成为一个现代化的AI代理管理平台，提供：

  • 用户认证：使用NextAuth.js和PostgreSQL进行安全的电子邮件/密码身份验证
  • AI代理管理：用于创建和配置AI代理的仪表板
  • MCP配置：支持模型上下文协议集成
  • 现代用户界面：支持黑暗模式的新野兽派设计系统
  • 响应式设计：移动优先的方法，确保所有设备的最佳体验

🚀 快速开始

先决条件

  • 包子 安装
  • Docker和Docker Compose for PostgreSQL

安装

  1. 克隆存储库
git clone <repository-url>
cd airtable-chatbot
  1. 安装依赖项
bun install
  1. 设置环境变量

创建一个 .env 文件：

DATABASE_URL="postgresql://postgres:postgres@localhost:5555/airtable_chatbot?schema=public"
NEXTAUTH_URL=http://localhost:3000
NEXTAUTH_SECRET=your-super-secret-key-change-this-in-production
  1. 启动PostgreSQL
docker-compose up -d
  1. 初始化数据库
bun run db:push
bun run db:seed
  1. 运行开发服务器
bun dev

打开 http://localhost:3000 查看应用程序。

测试凭证

  • 电子邮件: admin@example.com
  • 密码: password123

🛠️ 技术栈

  • 框架：Next.js 16.0.3（应用路由器）
  • 语言：TypeScript
  • 认证：NextAuth.js 4.24.13
  • 数据库：PostgreSQL 16+Prisma 6.19.0
  • 表单：反应钩子形式7.66.0+Zod 4.1.12
  • 数据获取：TanStack查询5.90.8
  • UI组件：shadcn/ui（自定义新野兽派主题）
  • 样式：顺风CSS 4
  • 图标：Lucide React
  • 程序包管理器：Bun

🚀 发展

命令

# Development
bun dev                    # Start dev server
bun run build             # Build for production
bun start                 # Start production server

# Database
bun run db:push           # Push schema to database
bun run db:seed           # Seed test data
bun run db:studio         # Open Prisma Studio

# Docker
docker-compose up -d      # Start PostgreSQL
docker-compose down       # Stop PostgreSQL
docker-compose logs -f    # View logs

📝 最佳实践

  1. 默认情况下为服务器组件 -仅在需要时添加“使用客户端”
  2. 使用Zod进行验证 -所有用户输入都必须经过验证
  3. 类型安全查询 -使用Prisma生成的类型
  4. 错误边界 -优雅地处理错误
  5. 无障碍 -使用语义HTML和ARIA标签

📄 许可证

MIT许可证-您可以自由地将此项目用作您自己应用程序的基础。

相关 MCP