Discord MCP 服务器

一个模型上下文协议（MCP）服务器，为 MCP 客户端（如 Claude Desktop）提供 Discord 集成功能。

可用工具

服务器信息

• list_servers: 列出可用服务器
• get_server_info: 获取服务器详细信息
• get_channels: 列出服务器中的频道
• list_members: 列出服务器成员及其角色
• get_user_info: 获取用户的详细信息

消息管理

• send_message: 向频道发送消息
• read_messages: 读取最近的消息历史
• add_reaction: 向消息添加反应
• add_multiple_reactions: 向消息添加多个反应
• remove_reaction: 从消息中移除反应
• moderate_message: 删除消息并禁言用户

频道管理

• create_text_channel: 创建新的文本频道
• delete_channel: 删除现有频道

角色管理

• add_role: 向用户添加角色
• remove_role: 从用户移除角色

安装

1. 设置你的 Discord 机器人：

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

2. 克隆并安装包：

# 克隆仓库
git clone https://github.com/hanweg/mcp-discord.git
cd mcp-discord

# 创建并激活虚拟环境
uv venv
.venv\Scripts\activate # 在 macOS/Linux 上，使用：source .venv/bin/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"
      }
    }

通过 Smithery 安装

通过 Smithery 自动为 Claude Desktop 安装 Discord 服务器：

npx -y @smithery/cli install @hanweg/mcp-discord --client claude

许可证

MIT 许可证 - 详见 LICENSE 文件。