酒店营销助理（MCP建筑）
模块化、人工智能驱动的社交媒体营销系统 模型上下文协议（MCP） 酒店业的服务器。通过克劳德用自然语言与你的营销团队交谈。
🎯 是什么让这个特别
与传统的API体系结构不同，它使用 MCP服务器 -这意味着你可以与你的营销系统进行对话：
You: "What's trending on TikTok for street food this week?"
System: [Searches TikTok trends, analyzes data, returns insights]
You: "Create a post about our new burger and schedule it for 6pm tomorrow"
System: [Generates caption with brand voice, suggests hashtags, schedules post]🏗️ 建筑
MCP服务器（微服务）
每个服务器都是一个专门的AI代理，通过模型上下文协议公开工具：
数据收集层
mcp-instagram-analytics-Instagram商业账户洞察和帖子分析mcp-facebook-insights-Facebook页面分析和参与度数据mcp-tiktok-scraper-TikTok趋势检测和病毒式内容分析
处理层
mcp-sentiment-analyzer-使用变压器进行情绪分析mcp-trend-detector-跨平台趋势聚合
内容自动化层
mcp-content-generator-人工智能字幕和后期制作（带品牌声音）mcp-post-scheduler-多平台岗位调度mcp-media-processor-图像/视频增强
数据存储
postgres-PostgreSQL 16适用于所有分析数据redis-API响应的缓存层
🚀 快速开始
先决条件
- 已安装Docker和Docker Compose
- Meta开发者账户（用于Instagram/Facebook API）
- Anthropic API密钥（用于内容生成）
- Instagram商业账号
- 脸书主页
1.克隆和设置
cd C:\Users\godja\Desktop\hospitality_marketing_assistant_claude
cp .env.example .env2.配置环境变量
编辑 .env 使用您的凭据：
# Meta API (Required)
META_APP_ID=your_app_id
META_APP_SECRET=your_app_secret
META_ACCESS_TOKEN=your_access_token
INSTAGRAM_BUSINESS_ACCOUNT_ID=your_ig_business_id
FACEBOOK_PAGE_ID=your_page_id
# Anthropic API (Required for content generation)
ANTHROPIC_API_KEY=your_anthropic_key
# Brand Configuration
BRAND_VOICE_PROFILE=dracula # or professional, casual
BUSINESS_NAME=Your Restaurant Name3.启动系统
docker-compose up -d这将开始：
- ✅ PostgreSQL数据库（端口5432）
- ✅ Redis缓存（端口6379）
- ✅ 所有MCP服务器
4.验证一切都在运行
docker-compose ps所有服务都应显示 Up 状态。
📚 获取API凭据
Instagram和Facebook（Meta Graph API）
- 创建元应用程序
- 首选https://developers.facebook.com/apps/ - 创建新应用→ 业务类型 - 添加Instagram基本显示和Instagram图形API
- 获取访问令牌
- 使用图形API资源管理器：https://developers.facebook.com/tools/explorer/ - 选择您的应用程序 - 添加权限： instagram_basic, instagram_manage_insights, pages_read_engagement, pages_show_list - 生成用户访问令牌 - 转换为长期代币 （60天）：
curl -i -X GET "https://graph.facebook.com/v18.0/oauth/access_token?grant_type=fb_exchange_token&client_id=YOUR_APP_ID&client_secret=YOUR_APP_SECRET&fb_exchange_token=YOUR_SHORT_LIVED_TOKEN"- 获取Instagram商业帐户ID
- 在图形API资源管理器中，查询： me?fields=accounts{instagram_business_account} - 复制 instagram_business_account.id
- 获取Facebook页面ID
- 转到您的Facebook页面 - 关于部分→ 页面ID
无烟煤API
- 首选https://console.anthropic.com/
- 创建帐户/登录
- API密钥→ 创建密钥
- 复制密钥（以开头
sk-ant-)
🔧 使用MCP服务器
选项1：通过克劳德桌面（推荐）
添加到您的Claude Desktop MCP配置(claude_desktop_config.json):
{
"mcpServers": {
"instagram-analytics": {
"command": "docker",
"args": ["exec", "-i", "mcp-instagram-analytics", "python", "server.py"]
},
"content-generator": {
"command": "docker",
"args": ["exec", "-i", "mcp-content-generator", "python", "server.py"]
}
}
}然后在Claude Desktop中，您可以问：
- “本周我在Instagram上发布的前五条帖子是什么？”
- “分析我在#burger和#street food上的标签表现”
- “为我们的新菜单启动生成标题”
选项2：直接API调用
每个MCP服务器都公开一个标准MCP接口。您可以通过编程方式与它们进行交互。
🛠️ 可用工具
Instagram分析服务器
# Get account insights
get_account_insights(date_range="last_7_days")
# Analyze top posts
analyze_post_performance(limit=10, sort_by="engagement_rate")
# Find best posting times
get_optimal_posting_times()
# Track hashtag performance
track_hashtag_performance(hashtags=["#burger", "#foodie"])
# Get audience demographics
get_audience_demographics()内容生成器服务器
# Generate caption
generate_caption(
topic="new burger menu",
platform="instagram",
include_hashtags=True
)
# Suggest hashtags
suggest_hashtags(
topic="street food",
count=10,
include_trending=True
)
# Generate full post
generate_full_post(
topic="weekend special",
platform="instagram",
post_goal="engagement"
)
# Create A/B test variations
create_content_variations(
base_caption="Your original caption",
num_variations=3
)
# Generate trend-based content
generate_trend_based_content(limit=5)🎨 品牌声音档案
该系统包括3个预先配置的品牌声音（ brand-voice/ 目录）：
1. 德古拉 (dracula.yaml)
充满黑色、神秘、哥特式主题的吸血鬼幽默。
例子：
“我们的特兰西瓦尼亚汉堡几个世纪以来一直萦绕在人们的梦中🦇 上面撒上焦糖大蒜（吸血鬼认可）、陈年切达干酪和我们的秘密“午夜酱汁”——真是美味极了。来吃一口。..如果你敢🧛♂️"
2. 专业的 (professional.yaml)
抛光、精致、注重质量。
例子：
“我们的招牌汉堡以优质、当地采购的牛肉开始，经过专业调味和烤至完美。每一口都能品尝到品质✨"
3. 随意 (casual.yaml)
友好，精力充沛，表情丰富，健谈。
例子：
“天哪，你们！😍 这个汉堡简直就是INSANE🔥 标记你的汉堡伙伴！ 👇"
切换品牌声音，设置 .env:
BRAND_VOICE_PROFILE=dracula # or professional, casual创建自己的，复制其中一个YAML文件并进行自定义！
📊 数据库模式
PostgreSQL数据库包括以下表：
social_accounts-连接的社交媒体帐户instagram_posts-发布带有参与度指标的数据instagram_insights-每日账户洞察facebook_posts-Facebook帖子分析tiktok_trends-热门标签和声音sentiment_analysis-内容的情感评分detected_trends-跨平台趋势聚合generated_content-人工智能生成的字幕和帖子scheduled_posts-后调度队列media_assets-媒体文件管理
🔍 监控
查看日志
# All services
docker-compose logs -f
# Specific service
docker-compose logs -f mcp-instagram-analytics数据库访问
# Connect to PostgreSQL
docker-compose exec postgres psql -U postgres -d hospitality_marketing
# View recent Instagram posts
SELECT post_id, caption, engagement_rate FROM instagram_posts ORDER BY timestamp DESC LIMIT 5;Redis缓存
# Connect to Redis
docker-compose exec redis redis-cli
# View cached keys
KEYS *
# Get cached value
GET instagram_insights:your_account_id:last_7_days📈 路线图
第一阶段：基础✅ （当前）
- \[x\] Docker编写设置
- \[x\] Instagram分析MCP服务器
- \[x\] 具有品牌声音的内容生成器
- \[x\] PostgreSQL架构
- \[x\] 基本文件
第二阶段：TikTok智能（未来2-3周）
- \[\]TikTok scraper（TypeScript+剧作家）
- \[\]趋势检测聚合
- \[\]情绪分析集成
第三阶段：自动化（2-3周后）
- \[\]使用Meta API发布发布后调度程序
- \[\]媒体处理器（图像增强、水印）
- \[\]自动趋势报告
第四阶段：高级功能
- \[\]竞争对手分析
- \[\]A/B测试框架
- \[\]Grafana仪表板
- \[\]Webhook集成
🐛 故障排除
“Meta API错误：访问令牌无效”
- 您的访问令牌已过期（最近1小时的短期令牌）
- 使用上面的curl命令转换为长期令牌（60天）
- 或在Graph API资源管理器中重新生成
“数据库连接被拒绝”
- 等待30秒，让PostgreSQL完全初始化
- 检查：
docker-compose logs postgres
“MCP服务器没有响应”
- 检查服务器日志：
docker-compose logs [service-name] - 验证环境变量是否设置正确
- 重新启动：
docker-compose restart [service-name]
“未检测到趋势”
- TikTok scraper需要3-5天的数据收集
- Instagram需要至少10个帖子才能进行有意义的分析
🤝 贡献
这是一个模板系统-根据您的需求进行定制！
要扩展的区域：
- 添加更多社交平台（推特/X、领英）
- 创建自定义品牌语音配置文件
- 构建web仪表板
- 添加电子邮件/短信营销集成
📝 许可证
麻省理工学院许可证-免费用于您的酒店业务！
🙏 鸣谢
内置：
- FastMCP -MCP服务器框架
- 人物克劳德 -AI内容生成
- 元图API -Instagram/Facebook数据
- PostgreSQL -数据存储
- 瑞迪斯 -缓存
______________________________________________________________________
问题？ 打开一个问题或检查每个服务目录中的文档。
准备好启动你的人工智能营销了吗？ 从第一阶段开始，逐步启用更多功能！ 🚀