内容
cp-discord-mod
一款适用于 **Discord轻量级 Model Context Protocol 服务器**。使用 discord.js v14 和 TypeScript 构建。
专注于重要的功能：踢出、、超时、角色、频道、审计日志和成员管理。无臃肿。
## 设置
### 1. 创建 Discord 机器人
1. 前往 [Discord 开发者门户](https://discord.com/developers/applications)
2. 创建新应用程序 → 机器人
3. 在 **特权网关意图** 下，启用：
- 服务器成员意图
- 消息内容意图
4. 复制机器人令牌
### 2. 安装
```bash
git clone https://github.com/YOUR_USERNAME/mcp-discord-mod.git
cd mcp-discord-mod
npm install
npm run build
```
### 3. 配置
将您的机器人令牌设置为环境变量：
```bash
export DISCORD_TOKEN="your_bot_token_here"
```
或创建 `.env` 文件：
```
DISCORD_TOKEN=your_bot_token_here
```
### 4. 添加到您的 MCP 客户端
添加到您的 MCP 配置（例如 `opencode.json`、`claude_desktop` 等）：
```json
"discord-mod": {
": "local",
"command": ["node", "/path/to/mord-mod/build/index.js"],
"env": {
"DIS_TOKEN": "your_bot_token_here"
}
}
}
```
工具
| 工具 | 描述 |
|---|---|
| `discord_mod_login` | 登录 Discord（如果设置了 DISCORD_TOKEN，则自动登录） |
| `discord_mod_kick_member` | 将成员从服务器中踢出 |
| `discord_mod_ban_member` | 封禁成员（可选的消息） |
| `discord_mod_unban_member` | 解封| `discord_mod_timeout_member 对成员进行指定时长的超时音） |
| `discord_mod_warn_member` | 向成员发送警告私信 |
| `discord_mod_list_bans` | 列出所有被封禁的用户 |
| `discord_mod_set_nickname` | 设置或清除成员的昵称 |
| `discord_mod_list_roles` | 列出服务器中的所有角色 |
| `discord_mod_create_role` | 创建新角色 |
discord_mod_edit_role` | 编辑角色属性 |
| `discord_mod_delete_role` | 删除角色 |
| `discord_mod_assign_role` | 将角色分配给成员 |
| `discord_mod_remove_role` | 从成员中移除| `discord_mod_create_category 创建频道分类 |
| `_create_channel` | 创建文本或语音频道 |
| `discord_mod_delete_channel` | 删除频道 |
| `discord_mod_edit_channel` | 编辑频道名称、主题、慢模式 |
| `discord_mod_set_permissions` | 在频道上设置角色/用户权限 |
| `discord_mod_remove_permissions` | 移除权限覆盖 |
| `discord_mod_list_members` | 列出服务器成员 |
| `discord_mod_get_member` | 获取详细的成员信息 |
| `discord_mod_list_servers` | 列出所有机器人服务器 |
| `discord_mod_get_server_info` | 获取服务器详细信息和频道 |
| `discord_mod_get_audit_log` | 查看服务器审计日志 |
| `discord_mod_send_dm` | 向用户发送私信 |
| `discord_mod_purge_messages` | 使用筛选器批量删除消息 |
| `discord_mod_bulk_delete_messages` | 按 ID 删除最多 100 条消息 |
| `discord_mod_pin_message` | 置顶消息 |
| `discord_mod_unpin_message` | 取消置顶消息 |
## 机器人权限
您的机器人在服务器中需要以下权限：
- **踢出成员**
- **封禁成员**
- **管理成员**（用于超时）
- **管理角色**
- **管理频道**
- **查看审计日志**
- **发送消息**
- **读取消息历史记录**
- **管理消息**（用于清理）
## 许可证
MIT
