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 
   cd marketing-mcp
   cp .env.example .env.local

1. 启动所有服务

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

1. 访问应用程序

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

1. 默认登录

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

选项2：本地开发

1. 安装依赖项

   npm install

1. 建立数据库

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

1. 启动 Redis

   redis-server

1. 配置环境

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

1. 构建MCP服务器

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

1. 启动开发服务器

   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

______________________________________________________________________

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