Discord MCP Server

Discord MCP Server

一个 Model Context Protocol (MCP) 服务，为 Claude Desktop 等 MCP 客户端提供 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 Developer Portal 创建新应用
   • 创建机器人并复制令牌
   • 启用所需的特权意图：
     • MESSAGE CONTENT INTENT
     • PRESENCE INTENT
     • SERVER MEMBERS INTENT
   • 使用 OAuth2 URL Generator 邀请机器人加入你的服务

2. 克隆并安装软件包：

# Clone the repository
git clone https://github.com/hanweg/mcp-discord.git
cd mcp-discord

# Create and activate virtual environment
uv venv
.venv\Scripts\activate # On macOS/Linux, use: source .venv/bin/activate

### If using Python 3.13+ - install audioop library: `uv pip install audioop-lts`

# Install the package
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 Server：

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

许可证

MIT License——详情请参阅 LICENSE 文件。