Genesys MCP

适用于 Genesys Cloud 的供应商中立型模型上下文协议 (MCP) 服务器。

genesys-mcp 是一个模型上下文协议 (MCP) 服务器，它将 Genesys Cloud 平台的功能（队列、对话、用户、状态、分析）作为 MCP 工具、资源和提示词公开。任何兼容 MCP 的 AI 智能体都可以通过它与 Genesys 通信：Claude Desktop、Claude Code、Cursor、Continue、Cline，以及任何基于 LangGraph、LangChain、CrewAI、AutoGen 或原始提供商 SDK 构建的自定义智能体。

状态

v0.1.0 — 预发布版。 框架、传输层和可靠性层已就位。第一批只读工具将在 v0.2 中发布；精选的写入操作（在 --enable-writes 标志下）以及资源/提示词将在 v0.3 中发布。v1.0 版本将通过 PyPI、Docker (GHCR)、npx shim 和 MCPB 捆绑包发布所有功能。

Related MCP server: agent-notify

为什么选择它

MCP 生态系统中已经有一个 Genesys Cloud 服务器，但它仅支持 stdio 而没有 HTTP 传输，没有按请求的身份验证上下文（整个进程仅由一个模块全局布尔值控制），并且没有生产级的可靠性层（没有 429 处理、没有令牌刷新、没有结构化日志记录）。genesys-mcp 专为生产环境设计：支持托管的流式 HTTP、按请求身份验证、感知 429 的重试、401 自动刷新、结构化日志和 OpenTelemetry 追踪——从第一天起就具备所有这些功能，且完全供应商中立。

快速入门

工具尚未发布——这些代码片段展示了安装模式。v0.2 将在此处列出实际的工具界面。

Claude Desktop

在你的 claude_desktop_config.json 中的 mcpServers 下添加一个条目：

{
  "mcpServers": {
    "genesys": {
      "command": "uvx",
      "args": ["genesys-mcp"],
      "env": {
        "GENESYS_REGION": "mypurecloud.com",
        "GENESYS_CLIENT_ID": "...",
        "GENESYS_CLIENT_SECRET": "..."
      }
    }
  }
}

Claude Code 或 Cursor

在你的编辑器 MCP 服务器配置中添加一个条目（Claude Code 为 .claude/settings.json，Cursor 为 Cursor MCP 设置面板）：

{
  "mcpServers": {
    "genesys": {
      "command": "genesys-mcp",
      "args": ["--transport", "stdio"],
      "env": {
        "GENESYS_REGION": "mypurecloud.com",
        "GENESYS_CLIENT_ID": "...",
        "GENESYS_CLIENT_SECRET": "..."
      }
    }
  }
}

Python 编程调用

通过官方 mcp Python 客户端通过 stdio 或 HTTP 连接：

from mcp import ClientSession, StdioServerParameters
from mcp.client.stdio import stdio_client

params = StdioServerParameters(command="genesys-mcp", args=["--transport", "stdio"])

async with stdio_client(params) as (read, write):
    async with ClientSession(read, write) as session:
        await session.initialize()
        # tools = await session.list_tools()  # available from v0.2

对于 HTTP 传输，运行 genesys-mcp --transport http --port 8000 并将你的 MCP 客户端连接到 http://localhost:8000。

安装

pip install genesys-mcp

即将推出的 v1.0：发布在 PyPI、GHCR、npm shim，以及作为附加在 GitHub Releases 上的 MCPB 捆绑包。

传输方式

两种传输方式共享相同的工具界面。传输选择由环境变量 (MCP_TRANSPORT=stdio|http) 或 CLI 参数 (--transport) 驱动。

安全性

v0.x 中的 HTTP 传输是未经身份验证的。MCP 框架层不执行任何调用者身份验证；服务器信任任何能够访问监听端口的进程。操作员有两种负责任的部署选项：

1. 仅绑定到 127.0.0.1（默认的 MCP_HOST），并允许本地智能体通过回环地址连接。

2. 仅在反向代理（nginx、Caddy、Cloudflare Access、API 网关）之后绑定到非回环地址，由代理在转发到 genesys-mcp 之前执行身份验证和授权。

在没有前端身份验证层的情况下绑定到 0.0.0.0 会将上游 Genesys 凭据暴露给网络上的任何人。因此，Docker 镜像默认 MCP_HOST=127.0.0.1；确实需要公共绑定的操作员必须通过 -e MCP_HOST=0.0.0.0 显式选择。

具有一流身份验证、审计和 RBAC 的托管式多租户网关已列入 Pro/SaaS 路线图（参见 docs/warm/decisions.md 中的 ADR-006）。

信任模型

在安装插件或在生产环境中运行此程序之前，需要了解以下几点：

• 入口点插件 (genesys_mcp.plugins 组) 在服务器进程中执行，拥有对服务器所拥有的每个依赖项、环境变量和 Genesys 凭据的完全访问权限。请仅安装你信任的插件。

• 许可证钩子 (genesys_mcp.license 组) 是一个功能门控，而不是安全控制。任何已安装的包都可以注册一个，任何插件都可以忽略其结果。它存在是为了让 Pro 包能够表达授权；请据此对待。

• OAuth 客户端密钥 从环境变量（以及存在的 .env 文件）中加载，服务器本身从不记录它们。我们无法保证下游插件也是如此——请审查它们，或者在运行 LOG_LEVEL=INFO 时检查输出，然后再将密钥交给它们。

配置

配置从环境变量（或 .env 文件）中读取。完整列表请参见 .env.example。最重要的变量：

开发

git clone https://github.com/digitalvanguardsolutions/genesys-mcp.git
cd genesys-mcp

uv sync --all-extras

uv run pytest
uv run ruff check src tests
uv run mypy src

uv run genesys-mcp --transport stdio

pre-commit install 将配置 ruff、mypy 和推送前的 pytest 运行。

许可证

MIT — 参见 LICENSE。版权所有 2026 Digital Vanguard Solutions。