Zendesk Help Center MCP Server

🚀 Zendesk 幫助中心 MCP 服務器

這是一個與 Zendesk 幫助中心 API 接口的 Model Context Protocol (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. 在根目錄中創建一個 .env 文件，填入你的 Zendesk 憑據：

   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 (string, 必填)：搜索關鍵詞
• locale (string, 可選)：語言代碼（例如，'en'，'ja'，'en-us'）
• page (number, 可選)：頁碼
• per_page (number, 可選)：每頁結果數（最大 100）

2. getArticle

通過 ID 獲取特定的 Zendesk 幫助中心文章的詳細信息。 參數：

• id (number, 必填)：文章 ID
• locale (string, 可選)：語言代碼（例如，'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 並遵循 Model Context Protocol 規範。 要以開發模式運行並自動重新加載：

npm run dev

📄 許可證

本項目採用 MIT 許可證。

🤝 貢獻

歡迎大家貢獻代碼！請隨意提交 Pull Request。