🚀 Discord MCP 服务器

一个提供 Discord 集成功能的 Model Context Protocol (MCP) 服务器，适用于像 Claude Desktop 这样的 MCP 客户端，能为用户带来便捷的 Discord 交互体验。

🚀 快速开始

本 Discord MCP 服务器提供了丰富的工具，可帮助你在 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

手动安装步骤

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： 在 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 文件。