Zendesk 帮助中心 MCP 服务器

这是一个与 Zendesk 帮助中心 API 进行交互的模型上下文协议（MCP）服务器，允许与 Claude Desktop 和其他兼容 MCP 的客户端进行集成。

功能

• 文章搜索：在您的 Zendesk 帮助中心中搜索文章
• 文章详情：通过 ID 获取特定文章的详细信息

预备条件

• Node.js（v18 或更高版本）
• 具有 API 访问权限的 Zendesk 账户
• Zendesk API 密钥

安装

1. 克隆此仓库：

   git clone https://github.com/yourusername/zendesk-help-center-mcp-server.git
   cd zendesk-help-center-mcp-server
   

2. 安装依赖项：

   npm install
   

3. 在根目录下创建一个包含您的 Zendesk 凭证的 .env 文件：

   ZENDESK_SUBDOMAIN=your-subdomain
   ZENDESK_EMAIL=your-email@example.com
   ZENDESK_API_TOKEN=your-api-token
   

   您可以复制 .env.example 文件并填写您的详细信息：

   cp .env.example .env
   

构建和运行

1. 构建项目：

   npm run build
   

2. 启动服务器：

   npm start
   

该服务器将在标准输入/输出上运行，使其与 Claude Desktop 和其他 MCP 客户端兼容。

可用工具

该服务器提供以下工具：

1. searchArticles

在您的 Zendesk 帮助中心中搜索文章。

参数：

• query（字符串，必需）：搜索关键词
• locale（字符串，可选）：地区代码（例如，'en'，'ja'，'en-us'）
• page（数字，可选）：页码
• per_page（数字，可选）：每页结果数量（最大 100）

2. getArticle

通过 ID 获取特定 Zendesk 帮助中心文章的详细信息。

参数：

• id（数字，必需）：文章 ID
• locale（字符串，可选）：地区代码（例如，'en'，'ja'，'en-us'）

使用与 Claude Desktop

添加到 Claude 的 mcpServers 配置

在 Claude 的设置文件中的 mcpServers 部分添加以下配置：

{
  "mcpServers": {
    "zendeskHelpCenter": {
      "command": "npx",
      "args": ["-y", "github:hidechae/zendesk-help-center-mcp-server"],
      "env": {
        "ZENDESK_SUBDOMAIN": "your-subdomain",
        "ZENDESK_EMAIL": "your-email@example.com",
        "ZENDESK_API_TOKEN": "your-api-token"
      }
    }
  }
}

添加此配置后，您可以在 Claude 中使用 Zendesk 帮助中心工具。

开发

此项目使用 TypeScript 并遵循模型上下文协议规范。

要在开发模式下运行并自动重新加载：

npm run dev

许可证

MIT

贡献

欢迎贡献！请随时提交拉取请求。