Discord代理MCP
AI驱动的Discord服务器管理 -一个生产就绪的模型上下文协议(MCP)服务器,配备71个工具,通过Claude AI实现全面的Discord自动化。
文档
查看完整文档→
- 入门指南
- 71工具参考
- 互动提示
- 部署指南
- api参考
- 故障排除
这是什么?
Discord Agent MCP将Claude AI与Discord连接起来,让您通过自然语言管理服务器。与其点击Discord的界面或编写代码,不如告诉Claude你想要什么:```
"Create a gaming community server with voice channels for different games,
a welcome channel, and moderator roles"
Claude使用此MCP服务器提供的71个Discord管理工具处理其余部分。
______________________________________________________________________
## 特性
### 71个Discord工具
|类别|工具|描述|
|----------|-------|-------------|
|消息|10|发送、编辑、删除、反应、固定消息|
|频道|10|创建、修改、删除频道和权限|
|话题|3|创建和管理论坛话题|
|服务器|7|设置、webhooks、邀请、审核日志|
|成员|3|信息、列表、昵称|
|角色|7|创建、分配、修改角色|
|适度|6|踢、禁令、超时、管理禁令|
|表情符号|4|自定义表情符号管理|
|贴纸|4|自定义贴纸管理|
|活动|6|预定活动|
|自动修改|5|自动审核规则|
|命令|6| Slash命令管理|
### 生产就绪
- **持久连接**:具有自动重新连接功能的强大Discord.js客户端
- **类型安全**:带有Zod验证的完整TypeScript
- **全面错误**:详细的错误消息和解决指南
- **结构化日志记录**:具有可配置级别的JSON日志记录
- **灵活部署**:本地、Docker或Kubernetes
### Claude代码集成
对Anthropic的Claude Code CLI的一流支持:```bash
claude mcp add --transport http discord-agent http://localhost:3000/mcp
快速开始
1.先决条件
- Node.js 20.0.0+
- Discord机器人令牌(在此处创建一个)
2.安装```bash
git clone https://github.com/aj-geddes/discord-agent-mcp.git
cd discord-agent-mcp
npm install
### 3.配置```bash
cp .env.example .env
# Edit .env and add your DISCORD_TOKEN
4.跑步```bash
npm run build
npm start
Server runs at http://localhost:3000/mcp
### 5.连接到克劳德代码```bash
claude mcp add --transport http discord-agent http://localhost:3000/mcp
完整设置指南→
部署选项
码头工人```bash
docker build -t discord-mcp-server:latest .
docker run -d -p 3000:3000 -e DISCORD_TOKEN=your_token discord-mcp-server:latest
### Docker Compose```yaml
version: '3.8'
services:
discord-mcp:
build: .
ports:
- "3000:3000"
environment:
- DISCORD_TOKEN=${DISCORD_TOKEN}
restart: unless-stopped
库贝内特斯```bash
kubectl apply -f k8s/
**完整部署指南→**
______________________________________________________________________
## 配置
|变量|必填|默认|描述|
|----------|----------|---------|-------------|
| `DISCORD_TOKEN` | **是** |-| Discord机器人令牌|
| `TRANSPORT_MODE` |没有| `http` | `http` 或 `stdio` |
| `HTTP_PORT` |没有| `3000` |服务器端口|
| `LOG_LEVEL` |没有| `info` | `debug`, `info`, `warn`, `error` |
______________________________________________________________________
## 示例用法
连接后,在Claude Code中使用自然语言:
**服务器设置:**```
"Set up a gaming community with channels for Minecraft, Valorant, and general chat"
适度:```
"Timeout user 123456789 for 1 hour for spam"
**活动:**```
"Create a voice event called 'Game Night' for Saturday at 8 PM"
自动化:"Set up auto-moderation to block spam and timeout repeat offenders"
安全
- 从不提交代币 -使用
.env文件(gitignored) - 旋转令牌 -定期重新生成
- 最小特权 -仅授予必要的权限
- 审计日志 -监控机器人操作
贡献
欢迎投稿!拜托:
- 复刻仓库
- 创建要素分支
- 使用开发Discord服务器进行测试
- 提交拉取请求
看 贡献.md 作为指导方针。
资源
- 文档: aj-geddes.ithub.io/不协调剂-mcp
- MCP协议: 模型上下文协议.io
- 不和谐API: discritic.com/developers
- 问题: GitHub问题
许可证
MIT许可证-请参阅 许可证 了解详情。
Discord Agent MCP - AI-Powered Discord Server Management
Built with TypeScript, Discord.js, and the Model Context Protocol
