Genesys Cloud MCP Plus

🚀 Genesys Cloud 高级模型上下文协议服务器

一个全面的MCP服务器，提供15个强大的工具用于呼叫中心分析、实时监控和智能对话分析。专为企业级AI应用设计，并支持全渠道。

🌟 功能

📊 历史数据分析（8个工具）

• 队列通话量分析 - 比较不同队列的通话量
• 对话采样 - 获取具有代表性的对话样本
• 语音通话质量 - 分析MOS评分和通话质量指标
• 对话情感分析 - 跨交互的情感分析
• 对话主题 - 提取业务主题和意图
• 对话记录 - 带时间戳的完整对话记录
• 增强媒体搜索 - 多渠道对话发现
• 代理性能分析 - 按媒体类型细分代理指标

⚡ 实时监控（3个工具）

• 实时队列状态 - 实时队列指标和代理可用性
• 代理状态监控 - 当前代理状态和路由状态
• 活跃对话跟踪 - 监控正在进行的客户互动

🏷️ 结束码分析（1个工具）

• 综合结束码分析 - 理解交互类型和数量
• 多语言支持 - 处理阿拉伯语/英语双语环境
• 按队列过滤 - 针对特定队列或服务区域的分析

🔍 实用工具（3个工具）

• 队列搜索 - 通过名称查找队列，支持通配符
• 代理目录 - 监控代理信息和状态
• 增强对话搜索 - 跨所有媒体类型的高级过滤

📋 支持的媒体类型

• 📞 语音通话
• 💬 聊天互动
• 📧 邮件对话
• 📱 短信/文本消息
• 🤖 机器人互动
• 📹 视频通话
• 🌐 社交媒体互动
• 📞 回拨请求

🛠️ 安装

NPM安装

npm install -g genesys-cloud-mcp-plus

手动安装

git clone https://github.com/MakingChatbots/genesys-cloud-mcp-server.git
cd genesys-cloud-mcp-server
npm install
npm run build

⚙️ 配置

环境变量

export GENESYSCLOUD_REGION="your-region"  # 例如："mypurecloud.de", "mypurecloud.com"
export GENESYSCLOUD_OAUTHCLIENT_ID="your-client-id"
export GENESYSCLOUD_OAUTHCLIENT_SECRET="your-client-secret"

支持的区域

• mypurecloud.com (美洲)
• mypurecloud.de (欧洲中东非洲)
• mypurecloud.ie (爱尔兰)
• mypurecloud.com.au (亚太)
• mypurecloud.jp (日本)

所需的OAuth权限

您的OAuth客户端需要以下权限：

• analytics:conversationAggregate:view
• analytics:conversationDetail:view
• routing:queue:view
• users:basic:view
• presence:basic:view
• speechandtextanalytics:data:view

🚀 使用

Claude Desktop集成

添加到您的Claude Desktop配置中：

{
  "mcpServers": {
    "genesys-cloud-mcp-plus": {
      "command": "genesys-cloud-mcp-plus",
      "env": {
        "GENESYSCLOUD_REGION": "mypurecloud.de",
        "GENESYSCLOUD_OAUTHCLIENT_ID": "your-client-id",
        "GENESYSCLOUD_OAUTHCLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

命令行

# 启动MCP服务器
genesys-cloud-mcp-plus

# 开发模式
npm run dev

# 生产构建
npm run build

📚 工具参考

历史数据分析

工具	目的	使用场景
search_queues	通过名称查找队列	"查找所有销售队列"
query_queue_volumes	比较队列通话量	"今天哪个队列最忙？"
sample_conversations_by_queue	获取对话样本	"显示最近的支持电话"
voice_call_quality	分析通话质量	"检查对话X的通话质量"
conversation_sentiment	情感分析	"这些电话的情感如何？"
conversation_topics	主题检测	"讨论了哪些话题？"
conversation_transcript	完整记录	"获取对话X的记录"
enhanced_conversation_search	多媒体搜索	"查找今天的聊天对话"

实时监控

工具	目的	使用场景
real_time_queue_status	实时队列指标	"有多少代理可用？"
real_time_agent_presence	代理状态监控	"谁现在在线？"
live_conversation_monitoring	活跃互动	"正在发生哪些对话？"

分析与洞察

工具	目的	使用场景
wrap_up_code_analytics	交互类型分析	"今天有多少咨询？"
agent_media_type_performance	按渠道的代理表现	"John在聊天上的表现如何？"
agent_status_monitoring	代理目录	"显示所有活跃代理"
search_voice_conversations	语音特定搜索	"从这个号码找到语音通话"

🔍 示例查询

商业智能

"本周我们的支持队列前三个结束码是什么？"
"昨天处理最多聊天对话的代理是谁？"
"显示来自客户X的所有对话的情感分析"

运营监控

"目前有多少代理可用？"
"当前有哪些对话是活跃的？"
"哪个队列等待时间最长？"

质量保证

"找到通话质量评分差的对话"
"客户询问最多的主题是什么？"
"显示升级的通话记录"

🛡️ 企业特性

• 🔒 安全认证 - 使用客户端凭据的OAuth 2.0
• 🌍 多区域支持 - 适用于所有Genesys Cloud区域
• 🗣️ 多语言 - 支持双语环境（阿拉伯语/英语）
• 📊 综合分析 - 15种不同的分析视角
• ⚡ 实时数据 - 实时监控能力
• 🔧 生产就绪 - 错误处理、日志记录和重试逻辑

📖 文档

• AI代理指南 - 完整的AI实现指南
• 变更日志 - 版本历史和新功能
• API参考 - 工具详细文档

👥 作者与贡献者

原始作者

卢卡斯·伍德沃德 - MakingChatbots.com

• 创建了基础的MCP服务器，带有8个核心分析工具
• 建立了原始架构和Genesys Cloud集成

增强版

阿姆尔·哈利勒

• 添加了7个新工具，包括实时监控和结束码分析
• 增强了现有工具，改进了错误处理和性能
• 将基本服务器转变为全面的企业级平台

🤝 贡献

1. 分叉仓库
2. 创建功能分支
3. 进行更改
4. 为新功能添加测试
5. 提交拉取请求

📝 许可证

ISC许可证 - 详情见LICENSE

🔗 链接

• GitHub仓库
• NPM包
• MakingChatbots.com

📞 支持

对于问题、疑问或功能请求：

• GitHub Issues：在此报告
• 文档：查看AI代理指南以了解实施细节

---

为AI和呼叫中心社区打造 ❤️