MCP Discord

🚀 Discord MCP Server

A Model Context Protocol (MCP) server with Discord integration capabilities, suitable for MCP clients like Claude Desktop.

🚀 Quick Start

This is a Model Context Protocol (MCP) server that integrates with Discord, catering to MCP clients such as Claude Desktop.

✨ Features

Server Information

• get_server_info: Retrieve detailed server information.
• list_members: List server members and their roles.

Message Management

• send_message: Send a message to a channel.
• read_messages: Read the recent message history.
• add_reaction: Add a reaction to a message.
• add_multiple_reactions: Add multiple reactions to a message.
• remove_reaction: Remove a reaction from a message.
• moderate_message: Delete a message and timeout the user.

Channel Management

• create_text_channel: Create a new text channel.
• delete_channel: Delete an existing channel.

Role Management

• add_role: Add a role to a user.
• remove_role: Remove a role from a user.

Webhook Management

• create_webhook: Create a new webhook.
• list_webhooks: List the webhooks in a channel.
• send_webhook_message: Send a message via a webhook.
• modify_webhook: Update the settings of a webhook.
• delete_webhook: Delete a webhook.

📦 Installation

Installation via Smithery

Use Smithery to automatically install the Discord server for Claude Desktop:

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

1. Set up your Discord bot:

   • Create a new application in the Discord Developer Console.
   • Create a bot and copy the token.
   • Enable the required privileged intents:
     • Message Content Intent
     • User Presence Intent
     • Server Members Intent
   • Use the OAuth2 URL generator to invite the bot to your server.

2. Clone and install the package:

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

# Create and activate a virtual environment
uv venv
.venv\Scripts\activate

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

# Install the package
uv pip install -e .

3. Configure Claude Desktop (%APPDATA%\Claude\claude_desktop_config.json on Windows, ~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

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

📄 License

This project is licensed under the MIT License. For more details, please refer to the LICENSE file.