使用说明
MCP故障
Discord MCP(模型上下文协议)服务器,使AI助手能够与Discord平台进行交互。
概述
MCP Discord提供以下Discord相关功能:
- 登录Discord机器人
- 获取服务器信息
- 读取/删除频道消息
- 向指定频道发送消息(使用频道ID或频道名称)
- 检索论坛频道列表
- 创建/删除/回复论坛帖子
- 创建/删除文本频道
- 添加/删除消息反应
- 创建/编辑/删除/使用webhooks
目录
先决条件
-
Node.js(v16.0.0或更高版本)
-
npm(v7.0.0或更高版本)
-
具有适当权限的Discord机器人
- Bot令牌(可从 Discord开发者门户)
- 消息内容意图已启用
- 服务器成员意图已启用
- 已启用存在意图
-
Discord服务器中所需的权限:
最简单的设置
- 管理员(建议用于快速设置和完整功能)
或者,仅选择所需的权限:
- 发送消息
- 创建公共线程
- 在线程中发送消息
- 管理邮件
- 管理线程
- 管理渠道
- 管理 Webhooks
- 添加反应
- 查看频道
-
将您的Discord机器人添加到您的服务器
- 要将您的Discord机器人添加到服务器,请使用以下邀请链接之一(替换
INSERT_CLIENT_ID_HERE使用您的机器人客户端ID):- 管理员(完全访问权限): https://discord.com/oauth2/authorize?client_id=INSERT_CLIENT_ID_HERE&scope=bot&permissions=8
- 自定义权限(最低要求): https://discord.com/oauth2/authorize?client_id=INSERT_CLIENT_ID_HERE&scope=bot&permissions=52076489808
- 要将您的Discord机器人添加到服务器,请使用以下邀请链接之一(替换
注:
根据Discord的安全模型,机器人只能访问其明确添加到的服务器上的信息。
如果你想使用此MCP服务器访问特定的Discord服务器,你必须先将机器人添加到该服务器。
使用下面的邀请链接将机器人添加到目标服务器。
安装
通过Smithery安装
通过以下方式自动安装mcp discord 史密瑟里
手动安装
# Clone the repository
git clone https://github.com/barryyip0625/mcp-discord.git
cd mcp-discord
# Install dependencies
npm install
# Compile TypeScript
npm run build
配置
正常操作需要Discord机器人令牌。服务器支持两种传输方式:stdio和流式HTTP。
运输方式
-
标准输入输出 (默认)
- 用于基本用途的传统stdio传输
- 适用于简单的集成
-
可流式传输HTTP
- 用于更高级场景的基于HTTP的传输
- 支持无状态操作
- 可配置的端口号
配置选项
您可以通过两种方式提供配置:
- 环境变量:
DISCORD_TOKEN=your_discord_bot_token
- 使用命令行参数:
# For stdio transport (default)
node build/index.js --config "your_discord_bot_token"
# For streamable HTTP transport
node build/index.js --transport http --port 3000 --config "your_discord_bot_token"
使用Claude/Cursor
克劳德
- 使用stdio传输:
{
"mcpServers": {
"discord": {
"command": "node",
"args": [
"path/to/mcp-discord/build/index.js",
"--config",
"your_discord_bot_token"
]
}
}
}
- 使用流式HTTP传输:
{
"mcpServers": {
"discord": {
"command": "node",
"args": [
"path/to/mcp-discord/build/index.js",
"--transport",
"http",
"--port",
"3000",
"--config",
"your_discord_bot_token"
]
}
}
}
光标
- 使用stdio传输:
{
"mcpServers": {
"discord": {
"command": "cmd",
"args": [
"/c",
"node",
"path/to/mcp-discord/build/index.js",
"--config",
"your_discord_bot_token"
]
}
}
}
- 使用流式HTTP传输:
{
"mcpServers": {
"discord": {
"command": "cmd",
"args": [
"/c",
"node",
"path/to/mcp-discord/build/index.js",
"--transport",
"http",
"--port",
"3000",
"--config",
"your_discord_bot_token"
]
}
}
}
工具文档
基本功能
discord_login:登录Discorddiscord_send:向指定频道发送消息(支持频道ID和频道名称)discord_get_server_info:获取Discord服务器信息
渠道管理
discord_create_text_channel:创建文本频道discord_delete_channel:删除频道
论坛功能
discord_get_forum_channels:获取论坛频道列表discord_create_forum_post:创建论坛帖子discord_get_forum_post:获取论坛帖子discord_reply_to_forum:回复论坛帖子discord_delete_forum_post:删除论坛帖子
信息和反应
discord_read_messages:读取频道消息discord_add_reaction:在消息中添加反应discord_add_multiple_reactions:在消息中添加多个反应discord_remove_reaction:从消息中删除反应discord_delete_message:从频道中删除特定消息
网钩 管理
discord_create_webhook:为Discord频道创建新的webhookdiscord_send_webhook_message:使用webhook向Discord频道发送消息discord_edit_webhook:编辑Discord频道的现有webhookdiscord_delete_webhook:删除Discord频道的现有webhook
发展
# Development mode
npm run dev