discord-mcp

discord-mcp

3.1

If you are the rightful owner of discord-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

An MCP (Model Context Protocol) server for Discord API integration with Claude, enabling interaction with Discord servers through various tools.

Discord MCP Server

An MCP (Model Context Protocol) server for Discord API integration with Claude. This server allows Claude to interact with Discord servers via tools that perform actions such as sending messages, reading messages, and managing server resources.

Prerequisites

  • Node.js 16 or higher
  • A Discord bot token (create one at the Discord Developer Portal)
  • Appropriate bot permissions:
    • Read Messages/View Channels
    • Send Messages
    • Read Message History
    • (Optional) Manage Roles, Manage Channels, etc. depending on functionality needed

Installation

  1. Clone this repository
  2. Install dependencies:
    npm install
    
  3. Build the project:
    npm run build
    

Configuration

Create a .env file in the root directory with:

DISCORD_TOKEN=your_discord_bot_token_here

Usage

  1. Start the server:

    npm start
    
  2. Configure Claude Desktop:

    • Add to Claude Desktop's configuration file:
    {
      "mcpServers": {
        "discord": {
          "command": "node",
          "args": ["path/to/discord-mcp/build/index.js"],
          "env": { "DISCORD_TOKEN": "your_discord_bot_token_here" }
        }
      }
    }
    

Available Tools

  • send-message: Send a message to a Discord channel
  • read-messages: Read recent messages from a Discord channel
  • list-channels: List available channels in the server
  • list-servers: List servers the bot has access to
  • get-user-info: Get information about a specific user

Security Considerations

  • The Discord bot token grants access to your Discord bot. Keep it secure.
  • The bot can only access servers it has been invited to.
  • Actions are limited by the bot's permissions in each server.

License

MIT