Genesys Cloud MCP Server

Genesys Cloud MCP 服务

一个用于 Genesys Cloud Platform API 的 Model Context Protocol（MCP）服务。

功能

工具	描述
搜索队列	按队列名称搜索队列（支持通配符）
查询队列容量	按队列 ID 获取会话容量和成员数量
按队列抽样会话	获取某个队列 ID 的代表性会话 ID 样本
语音通话质量	按 ID 获取一个或多个会话的语音通话质量指标
会话情感	按 ID 获取一个或多个会话的情感
会话主题	按 ID 获取会话主题
搜索语音会话	按可选条件搜索语音会话
会话转录文本	获取会话转录文本
OAuth 客户端	获取所有 OAuth 客户端的列表
OAuth 客户端使用情况	获取指定时间段内的 OAuth 客户端使用情况

在 Claude Desktop 中使用

MCP Bundle

此 MCP 服务为每个发布版本提供一个 MCP Bundle（.mcpb 文件），这是一个可在 Claude Desktop 中一键安装的软件包。使用方法：

1. 从最新发布版本下载 .mcpb 文件
2. 在 Claude Desktop 中导航至 Settings > Extensions。
3. 使用 Claude 打开 .mcpb 文件
4. 为扩展配置 Region 和 OAuth Client

现在即可在对话中使用此扩展。

NPX

将以下内容添加到你的 claude_desktop_config.json：

{
  "mcpServers": {
    "genesys-cloud": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@makingchatbots/genesys-cloud-mcp-server"],
      "env": {
        "GENESYSCLOUD_REGION": "<PUT REGION HERE>",
        "GENESYSCLOUD_OAUTHCLIENT_ID": "<PUT OAUTHCLIENT ID HERE>",
        "GENESYSCLOUD_OAUTHCLIENT_SECRET": "<PUT OAUTHCLIENT SECRET HERE>"
      }
    }
  }
}

在 Gemini CLI 中使用

将以下内容添加到你的 .gemini/settings.json 文件中。你可以在官方指南中阅读更多设置说明。

{
  "mcpServers": {
    "genesysCloud": {
      "command": "npx",
      "args": ["-y", "@makingchatbots/genesys-cloud-mcp-server"],
      "env": {
        "GENESYSCLOUD_REGION": "${GENESYSCLOUD_REGION}",
        "GENESYSCLOUD_OAUTHCLIENT_ID": "${GENESYSCLOUD_OAUTHCLIENT_ID}",
        "GENESYSCLOUD_OAUTHCLIENT_SECRET": "${GENESYSCLOUD_OAUTHCLIENT_SECRET}"
      }
    }
  }
}

身份验证

目前仅支持 stdio 服务。要配置身份验证，你需要：

1. 在 Genesys Cloud 中创建 OAuth Client
2. 为其分配要使用的工具所需的权限
3. 引用服务时提供以下环境变量：
   • GENESYSCLOUD_REGION
   • GENESYSCLOUD_OAUTHCLIENT_ID
   • GENESYSCLOUD_OAUTHCLIENT_SECRET

开发

入门

nvm use
npm install
npm run dev

正在积极开发

这是一个个人项目，旨在创建一款对话式商业洞察工具。通过这个实用项目，我可以学习 MCP 服务，以及如何以便于大模型使用的方式呈现 Genesys Cloud 的平台 API。

项目将会有很多变化，我一定会在我的电子报中分享学习心得。