Zendesk帮助中心MCP服务器

一个与Zendesk帮助中心API交互的MCP服务器,支持与Claude Desktop及其他MCP兼容客户端的集成,提供文章搜索和详情获取功能。

  • by hidechae
  • TypeScript
  • 本地部署
  • 6 星标
  • 更新于
在 GitHub 查看 hidechae/zendesk-help-center-mcp-server

使用说明

Zendesk帮助中心MCP服务器

模型上下文协议(MCP)服务器,与Zendesk帮助中心API接口,允许与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. 搜索文章

在Zendesk帮助中心搜索文章。

参数:

  • query (字符串,必填):搜索关键字
  • locale (字符串,可选):区域设置代码(例如,“en”、“ja”、“en-us”)
  • page (数字,可选):页码
  • per_page (数字,可选):每页结果数(最多100个)

2.获取文章

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

参数:

  • id (数字,必填):文章ID
  • locale (字符串,可选):区域设置代码(例如,“en”、“ja”、“en-us”)

与Claude Desktop一起使用

添加到克劳德的 mcpServers 配置

将以下配置添加到 mcpServers Claude设置文件中的部分:

{
  "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

许可证

麻省理工学院

贡献

欢迎投稿!请随时提交拉取请求。