AI导哈

营销自动化平台

一个基于AI的营销自动化系统，专为韩国认证考试移动应用设计，提供认证、数据库设置、MCP服务器架构和基础仪表板UI。

  • by BOMBEZZANG
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 BOMBEZZANG/marketing_mcp

使用说明

MCP营销自动化平台 - 第一阶段：基础建设

一个基于Next.js、TypeScript和模型上下文协议（MCP）构建的、为韩国认证考试移动应用提供人工智能驱动的营销自动化系统。

项目概述

这是 第一阶段：基础 关于MCP营销自动化平台。它建立了核心基础设施，包括身份验证、数据库设置、MCP服务器架构以及基本仪表板用户界面。

主要特点

  • ✅ JWT 认证系统 - 基于令牌的安全认证，支持刷新令牌
  • ✅ PostgreSQL 数据库 - 完整的架构，包含用户、会话、博客文章和MCP服务器的迁移方案
  • ✅ Redis 缓存 - 高性能缓存层
  • ✅ MCP服务器基础设施 - 基础服务器模板，包含ping、状态和信息工具
  • ✅ Next.js 控制台仪表盘 - 使用Tailwind CSS打造的现代、响应式用户界面
  • ✅ TypeScript - 应用程序全程类型安全
  • ✅ 翻译成中文是：✓（正确/对） Docker 支持 - 容器化开发和生产环境

技术栈

  • 前端Next.js 15，React 19，TypeScript，Tailwind CSS 4
  • 后端Node.js，PostgreSQL，Redis
  • 认证带有httpOnly的JWT（JSON Web Token）cookies
  • **ORM（对象关系映射）**Drizzle ORM
  • MCP模型上下文协议SDK
  • 部署Docker，Docker Compose

快速入门

选项1：使用Docker（推荐）

  1. 克隆并设置环境

    git clone <repository-url>
cd marketing-mcp
cp .env.example .env.local

  2. 启动所有服务

    docker-compose -f docker/docker-compose.yml up -d

  3. 访问应用程序

    • 仪表板：http://localhost:3000
    • pgAdmin: http://localhost:5050

  4. 默认登录

    • 电子邮箱： admin@example.com
    • 密码： admin123

选项2：本地开发

  1. 安装依赖项

    npm install

  2. 建立数据库

    createdb marketing_mcp
psql -d marketing_mcp -f migrations/001_initial_schema.sql

  3. 启动 Redis

    redis-server

  4. 配置环境

    cp .env.example .env.local
# Edit .env.local with your credentials

  5. 构建MCP服务器

    cd mcp-servers/base-server
npm install && npm run build
cd ../..

  6. 启动开发服务器

    npm run dev

API 端点

认证

  • POST /api/auth/login - 用户登录
  • POST /api/auth/logout - 用户登出
  • GET /api/auth/verify - 验证会话
  • POST /api/auth/refresh - 刷新令牌

系统

  • GET /api/health - 健康检查
  • GET /api/mcp/status - MCP服务器状态

项目结构

src/
├── app/              # Next.js app router
├── components/       # React components
├── lib/             # Core libraries
│   ├── auth/        # Authentication
│   ├── db/          # Database
│   ├── redis/       # Cache
│   ├── mcp/         # MCP servers
│   └── utils/       # Utilities
├── hooks/           # React hooks
├── stores/          # State stores
└── types/           # TypeScript types

mcp-servers/         # MCP implementations
migrations/          # Database migrations
docker/              # Docker configs

环境变量

见 .env.example 适用于所有配置选项。

关键变量：

  • DATABASE_URL - PostgreSQL 连接
  • REDIS_HOST / REDIS_PORT - Redis 连接
  • JWT_SECRET - JWT 密钥（至少 32 个字符）

MCP基础服务器

位于 mcp-servers/base-server/提供：

  • ping - 测试连接性
  • 状态 - 健康指标
  • 信息 - 服务器信息

开发阶段

✅ 第一阶段：基础（已完成）

  • 项目设置
  • 认证系统
  • 数据库配置
  • MCP基础设施
  • 仪表盘用户界面

🔜 第二阶段：核心功能

  • 博客数据库MCP服务器
  • 内容工作流程
  • AdMob 集成
  • 分析（或“数据分析”）

🔜 第三阶段：高级功能

  • Naver爬虫
  • 预测性营销
  • 活动管理

🔜 第四阶段：优化

  • 性能优化
  • A/B测试
  • 高级分析

安全

  • 在httpOnly Cookie中的JWT令牌
  • 使用 Zod 进行输入验证
  • 使用 bcrypt 对密码进行哈希处理
  • 参数化查询
  • 速率限制

故障排除

数据库连接：

pg_isready
psql -d marketing_mcp -c "SELECT 1"

Redis 连接：

redis-cli ping

端口正在使用中：

lsof -ti:3000 | xargs kill -9

文档

见 Document/ 详细规格目录：

  • 营销_MCP_发展计划.md
  • 第一阶段计划.md

第一阶段状态✅ 完成 下一步行动进入第二阶段 - 核心功能

相关 MCP