项目简介

该项目是一个基于 Model Context Protocol (MCP) 实现的服务器，专门用于集成大语言模型（LLM）与 Genesys Cloud 平台。它允许 LLM 通过标准的 MCP 接口访问 Genesys Cloud 的能力，例如搜索队列信息。

主要功能点

Genesys Cloud 集成: 通过 Genesys Cloud Platform API 连接到 Genesys Cloud 环境。
工具注册与调用: 注册并提供 LLM 可以调用的工具。目前包含一个工具：
- 按名称搜索队列: 根据提供的队列名称（支持通配符），在 Genesys Cloud 组织中搜索匹配的队列，并返回队列的名称和 ID (最多前 5 个结果)。
标准协议支持: 使用 MCP 协议，通过标准输入/输出 (Stdio) 传输与兼容的 MCP 客户端（LLM 应用）进行通信。

安装步骤

克隆仓库:

git clone https://github.com/MakingChatbots/genesys-cloud-mcp-server.git
cd genesys-cloud-mcp-server

安装依赖: 确保已安装 Node.js 和 npm（推荐使用 nvm 管理 Node.js 版本）。

nvm use # 如果使用 nvm
npm install

服务器配置

该 MCP 服务器需要访问 Genesys Cloud API，因此需要配置 Genesys Cloud OAuth 客户端凭据和区域。这些信息通过环境变量提供。

'GENESYSCLOUD_REGION': 您的 Genesys Cloud 组织所在的区域（例如 'mypurecloud.ie', 'usw2.pure.cloud'）。
'GENESYSCLOUD_OAUTHCLIENT_ID': Genesys Cloud OAuth 客户端 ID，用于客户端凭据授权。
'GENESYSCLOUD_OAUTHCLIENT_SECRET': Genesys Cloud OAuth 客户端 Secret，用于客户端凭据授权。

对于 MCP 客户端，需要知道如何启动此服务器作为子进程。典型的 MCP 客户端配置会包含服务器的名称、启动命令和参数。

MCP 客户端配置示例所需信息：

Server Name: Genesys Cloud
Command: npm
Args: ["run", "dev"]
Environment Variables: 需要传递 'GENESYSCLOUD_REGION', 'GENESYSCLOUD_OAUTHCLIENT_ID', 'GENESYSCLOUD_OAUTHCLIENT_SECRET' 这三个环境变量给服务器进程。

基本使用方法

安装并配置好环境变量后，可以直接运行服务器：

npm run dev

服务器会启动并通过标准输入/输出等待 MCP 客户端连接和发送请求。MCP 客户端（如一个 LLM 应用）可以通过调用 'search_queues_by_name' 工具，并提供 'name' 参数来使用其功能。

例如，一个 MCP 客户端可能会发送一个 JSON-RPC 请求来调用此工具。服务器收到请求后，会执行 Genesys Cloud API 调用，并将结果（找到的队列列表或错误信息）格式化为文本内容返回给客户端。

关键词