🚀 Discord MCP 服务器
一个提供 Discord 集成功能的 Model Context Protocol (MCP) 服务器，适用于像 Claude Desktop 这样的 MCP 客户端。借助该服务器，能让 Claude Desktop 等客户端更好地与 Discord 进行交互，拓展使用场景。
🚀 快速开始
本 Discord MCP 服务器为 MCP 客户端（如 Claude Desktop）提供了丰富的 Discord 集成功能。下面将详细介绍服务器的可用工具、安装步骤等内容。
✨ 主要特性
可用工具
服务器信息
get_server_info：可获取详细的服务器信息，助你全面了解服务器状态。list_members：能列出服务器成员及其角色，方便进行成员管理。
消息管理
send_message：可向频道发送消息，实现信息的及时传递。read_messages：用于阅读最近的消息历史，便于回顾交流内容。add_reaction：能在消息上添加反应，增加互动性。add_multiple_reactions：可向消息添加多个反应，丰富互动形式。remove_reaction：从消息中移除反应，灵活管理互动效果。moderate_message：删除消息并对用户设置超时，实现消息的有效管理。
频道管理
create_text_channel：创建新的文本频道，满足多样化的交流需求。delete_channel：删除现有的频道，优化频道结构。
角色管理
add_role：向用户添加角色，合理分配权限。remove_role：从用户移除角色，灵活调整权限设置。
Webhook 管理
create_webhook：创建一个新的 webhook，实现自动化消息推送。list_webhooks：列出频道中的 webhooks，方便管理。send_webhook_message：通过 webhook 发送消息，提高消息传递效率。modify_webhook：更新 webhook 的设置，满足不同的使用场景。delete_webhook：删除一个 webhook，清理不再使用的配置。
📦 安装指南
通过 Smithery 安装
使用 Smithery 可自动安装 Discord 服务器以适用于 Claude Desktop，操作命令如下：
npx -y @smithery/cli install @hanweg/mcp-discord --client claude
手动安装步骤
-
设置你的 Discord 机器人：
- 在 Discord 开发者控制台 创建一个新的应用程序。
- 创建一个机器人并复制令牌。
- 启用所需的特权意图：
- 消息内容意图
- 用户状态意图
- 服务器成员意图
- 使用 OAuth2 URL 生成器将机器人邀请到你的服务器。
-
克隆并安装包：
# 克隆仓库
git clone https://github.com/hanweg/mcp-discord.git
cd mcp-discord
# 创建并激活虚拟环境
uv venv
.venv\Scripts\activate
### 如果使用 Python 3.13+ - 安装 audioop 库：`uv pip install audioop-lts`
# 安装包
uv pip install -e .
- 配置 Claude Desktop：
在 Windows 上配置文件路径为
%APPDATA%\Claude\claude_desktop_config.json，在 macOS 上为~/Library/Application Support/Claude/claude_desktop_config.json，配置内容如下：
"discord": {
"command": "uv",
"args": [
"--directory",
"C:\\PATH\\TO\\mcp-discord",
"run",
"mcp-discord"
],
"env": {
"DISCORD_TOKEN": "your_bot_token"
}
}
📄 许可证
本项目采用 MIT License，有关详细信息，请参见 LICENSE 文件。