项目简介

Zendesk MCP服务器是一个基于Model Context Protocol (MCP) 的后端应用,旨在为大型语言模型 (LLM) 提供与Zendesk客户服务平台的深度集成。通过此服务器,LLM应用可以安全、便捷地访问Zendesk的工单、知识库等资源,并利用预设的工具和Prompt模板,实现智能工单分析、自动回复等功能。

主要功能点

  • 资源 (Resources): 提供对Zendesk知识库文章的访问,作为LLM的知识来源。
  • 工具 (Tools): 支持检索工单信息、获取工单评论、创建工单评论等操作,使LLM能够与Zendesk进行交互。
  • Prompt 模板 (Prompts): 内置工单分析和回复草拟Prompt,优化LLM在客服场景下的应用效果。

安装步骤

  1. 确保已安装 'uv' (或 'virtualenv' 和 'pip')。
  2. 克隆或下载此仓库代码到本地。
  3. 在项目根目录下,打开终端并执行命令 'uv venv && uv pip install -e .' (或 'uv build') 创建虚拟环境并安装项目依赖。
  4. 复制 '.env.example' 文件并重命名为 '.env',根据示例文件填写您的Zendesk域名 (ZENDESK_SUBDOMAIN)、邮箱 (ZENDESK_EMAIL) 和 API 密钥 (ZENDESK_API_KEY)。

服务器配置

{
  "mcpServers": {
      "zendesk": {
          "command": "uv",
          "args": [
              "--directory",
              "/path/to/zendesk-mcp-server",
              "run",
              "zendesk_mcp_server"
          ]
      }
  }
}
  • 'command': 运行服务器的命令,这里使用 'uv' 命令。
  • 'args': 传递给 'uv' 命令的参数列表。
    • '--directory': 指定服务器代码所在的目录,请替换 '/path/to/zendesk-mcp-server' 为您本地仓库的实际路径。
    • 'run': 使用 'uv run' 运行 Python 模块。
    • 'zendesk_mcp_server': 指定要运行的 Python 模块名称。

基本使用方法

  1. 启动 MCP 服务器。在项目根目录下,打开终端并执行命令 'uv run zendesk_mcp_server'。
  2. 在支持 MCP 客户端的 LLM 应用 (如 Claude) 中,配置上述服务器配置信息。
  3. 在 LLM 应用中,即可使用 "zendesk://" 协议访问知识库资源,并调用预定义的 "analyze-ticket"、"draft-ticket-response" Prompt 以及 "get_ticket"、"get_ticket_comments"、"create_ticket_comment" 工具,与Zendesk工单系统进行交互。

信息

分类

商业系统