Zendesk API MCP 服务器

一个全面的模型上下文协议 (MCP) 服务器，用于与 Zendesk API 交互。此服务器提供用于管理 Zendesk Support、Talk、Chat 和 Guide 产品的工具和资源。

## 功能

- 完整覆盖 Zendesk API 功能
- 用于管理工单、用户、组织等的工具
- 用于访问 Zendesk API 文档的资源
- 使用 Zendesk API 令牌进行安全身份验证

## 快速开始

### 前提条件

- Node.js 14 或更高版本
- 具有 API 访问权限的 Zendesk 帐户

### 安装

1. 克隆此存储库
2. 安装依赖项：
   ```
   npm install
   ```
3. 创建一个包含您的 Zendesk 凭据的 `.env` 文件：
   ```
   ZENDESK_SUBDOMAIN=您的子域名
   ZENDESK_EMAIL=您的邮箱@example.com
   ZENDESK_API_TOKEN=您的 API 令牌
   ```

### 运行服务器

启动服务器：
```
npm start
```

用于自动重启的开发：
```
npm run dev
```

### 使用 MCP Inspector 进行测试

使用 MCP Inspector 测试服务器：
```
npm run inspect
```

## 可用工具

### 工单
- `list_tickets`: 列出 Zendesk 中的工单
- `get_ticket`: 按 ID 获取特定工单
- `create_ticket`: 创建新工单
- `update_ticket`: 更新现有工单
- `delete_ticket`: 删除工单

### 用户
- `list_users`: 列出 Zendesk 中的用户
- `get_user`: 按 ID 获取特定用户
- `create_user`: 创建新用户
- `update_user`: 更新现有用户
- `delete_user`: 删除用户

### 组织
- `list_organizations`: 列出 Zendesk 中的组织
- `get_organization`: 按 ID 获取特定组织
- `create_organization`: 创建新组织
- `update_organization`: 更新现有组织
- `delete_organization`: 删除组织

### 组
- `list_groups`: 列出 Zendesk 中的客服组
- `get_group`: 按 ID 获取特定组
- `create_group`: 创建新的客服组
- `update_group`: 更新现有组
- `delete_group`: 删除组

### 宏
- `list_macros`: 列出 Zendesk 中的宏
- `get_macro`: 按 ID 获取特定宏
- `create_macro`: 创建新宏
- `update_macro`: 更新现有宏
- `delete_macro`: 删除宏

### 视图
- `list_views`: 列出 Zendesk 中的视图
- `get_view`: 按 ID 获取特定视图
- `create_view`: 创建新视图
- `update_view`: 更新现有视图
- `delete_view`: 删除视图

### 触发器
- `list_triggers`: 列出 Zendesk 中的触发器
- `get_trigger`: 按 ID 获取特定触发器
- `create_trigger`: 创建新触发器
- `update_trigger`: 更新现有触发器
- `delete_trigger`: 删除触发器

### 自动化
- `list_automations`: 列出 Zendesk 中的自动化
- `get_automation`: 按 ID 获取特定自动化
- `create_automation`: 创建新自动化
- `update_automation`: 更新现有自动化
- `delete_automation`: 删除自动化

### 搜索
- `search`: 搜索 Zendesk 数据

### 帮助中心
- `list_articles`: 列出帮助中心文章
- `get_article`: 按 ID 获取特定帮助中心文章
- `create_article`: 创建新的帮助中心文章
- `update_article`: 更新现有帮助中心文章
- `delete_article`: 删除帮助中心文章

### Talk
- `get_talk_stats`: 获取 Zendesk Talk 统计信息

### Chat
- `list_chats`: 列出 Zendesk Chat 对话

## 可用资源

- `zendesk://docs/{section}`: 访问 Zendesk API 不同部分的文档

## 许可证

MIT