Discord MCP 服务器

一个提供 Discord 集成功能的 Model Context Protocol (MCP) 服务器，适用于像 Claude Desktop 这样的 MCP 客户端。

可用工具

服务器信息

• 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

1. 设置你的 Discord 机器人：

   • 在 Discord 开发者控制台 创建一个新的应用程序
   • 创建一个机器人并复制令牌
   • 启用所需的特权意图：
     • 消息内容意图
     • 用户状态意图
     • 服务器成员意图
   • 使用 OAuth2 URL 生成器将机器人邀请到你的服务器

2. 克隆并安装包：

# 克隆仓库
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 .

3. 配置 Claude Desktop (%APPDATA%\Claude\claude_desktop_config.json 在 Windows 上，~/Library/Application Support/Claude/claude_desktop_config.json 在 macOS 上)：

    "discord": {
      "command": "uv",
      "args": [
        "--directory",
        "C:\\PATH\\TO\\mcp-discord",
        "run",
        "mcp-discord"
      ],
      "env": {
        "DISCORD_TOKEN": "your_bot_token"
      }
    }

许可证

MIT License - 有关详细信息，请参见 LICENSE 文件。