FeedMob AdPilot MCP服务器
基于FastMCP、Claude Agent SDK和mcp-ui构建的人工智能广告活动策划和创意生成系统。
特性
🎯 解析广告要求
从自然语言描述中提取结构化的活动参数。
🔍 进行广告研究
生成包含市场洞察、受众分析和平台策略的全面活动报告。
✍️ 生成广告文案
为您的目标平台和受众创建两种不同的广告文案变体。
🖼️ 生成广告图片
通过交互式选择为活动生成图像变体。
🎨 生成混合媒体
将所选图像与广告文案相结合，以获得完整的创意资产。
📊 活动管理
使用PostgreSQL持久性存储和检索活动数据。
快速开始
先决条件
- Node.js 20+
- Docker（用于PostgreSQL）
- 具有基岩访问权限的AWS帐户（适用于Claude Agent SDK）
安装
npm install配置
cp .env.example .env配置您的 .env 文件包含：
- Bedrock的AWS凭据
- PostgreSQL连接（或使用Docker）
- 可选：Tavilly API密钥用于增强研究
启动数据库
docker-compose up -d postgres运行开发服务器
npm run dev服务器启动时间 http://localhost:8080/mcp
使用MCP检查员进行测试
npm run mcp:inspect可用工具
| 工具 | 说明 |
|---|---|
parseAdRequirements | 解析自然语言活动需求 |
conductAdResearch | 生成全面的活动研究报告 |
generateAdCopy | 创建广告文案变体 |
generateAdImages | 生成图像变化 |
generateMixedMediaCreative | 合并图像并复制 |
getCampaign | 检索存储的活动数据 |
项目结构
├── src/
│ ├── index.ts # FastMCP server entry
│ ├── tools/ # MCP tool definitions
│ ├── services/ # Agent services (Claude SDK)
│ ├── utils/ # UI factories (mcp-ui)
│ ├── schemas/ # Zod validation schemas
│ └── plugins/ # Claude Agent skills
├── client-ui/ # Next.js chat interface
├── tests/ # Unit and property tests
├── docs/ # Documentation
└── .kiro/specs/ # Feature specifications端点
- 主控程序:
http://localhost:8080/mcp - 上海证券交易所:
http://localhost:8080/sse - 健康:
http://localhost:8080/health
发展
npm run dev # Start with hot reload
npm run build # Build for production
npm start # Run production build
npm test # Run tests
npm run typecheck # Type checking
npm run mcp:inspect # Visual debuggingDocker部署
看 部署.md 了解Coolify/Docker部署说明。
预构建图像可在以下网址获得：
ghcr.io/feedmob/feedmob_adpilot_mcp:latestghcr.io/feedmob/feedmob_adpilot_mcp-ui:latest
技术栈
- FastMCP -MCP服务器框架
- @mcp用户界面/服务器 -交互式UI组件
- @人工智能/克劳德试剂sdk -Claude Agent集成
- 萨德 -运行时类型验证
- PostgreSQL -活动数据持久性
- Vitest+快速检查 -测试
客户端UI
这 client-ui/ 目录包含一个连接到此MCP服务器的Next.js聊天界面。看 客户端用户界面/README.md 了解详情。
许可证
麻省理工学院