Discord Relay

🚀 MCP Relay Server

This MCP server allows Claude to send messages and prompts to a Discord channel and receive responses.

🚀 Quick Start

✨ Features

This MCP relay server enables seamless communication between Claude and Discord channels, facilitating the sending of messages and prompts and receiving corresponding responses.

📦 Installation

Step 1: Create a Discord Application and Bot

1. Visit the Discord Developer Console.
2. Click "New Application" and give it a name.
3. Navigate to the "Bot" section in the left sidebar.
4. Under the bot's token section, click "Reset Token" and copy the new token.
   • Keep this token secure! Do not share it publicly.
5. Enable the following under "Privileged Gateway Intents":
   • Message Content Intent
   • Server Members Intent
   • Presence Intent

Step 2: Invite the Bot to Your Server

1. Go to the "OAuth2" section in the left sidebar.
2. Select "URL Generator".
3. Under "Scopes", select:
   • bot
   • applications.commands
4. Under "Bot Permissions", select:
   • Send Messages
   • Embed Links
   • Read Message History
5. Copy the generated URL and open it in your browser.
6. Select your server and authorize the bot.

Step 3: Get the Channel ID

1. In Discord, enable Developer Mode:
   • Go to User Settings > App Settings > Advanced.
   • Turn on "Developer Mode".
2. Right - click on the channel you want to use.
3. Click "Copy Channel ID".

Step 4: Configure MCP Settings

The server needs to be configured in your MCP settings file. Add the following to your configuration file:

{
    "mcpServers": {
        "discord-relay": {
            "command": "node",
            "args": [
                "/ABSOLUTE/PATH/TO/MCP Relay/build/index.js"
            ],
            "env": {
                "DISCORD_TOKEN": "your_bot_token_here",
                "DISCORD_CHANNEL_ID": "your_channel_id_here"
            }
        }
    }
}

Replace:

• /ABSOLUTE/PATH/TO/MCP Relay with the actual path to your MCP Relay project.
• your_bot_token_here with your own Discord bot token.
• your_channel_id_here with your own Discord channel ID.

Note: Make sure to use absolute paths in the configuration.

💻 Usage Examples

Basic Usage

The server provides a tool named send - message that accepts the following parameters:

{
  type: 'prompt' | 'notification',  // Message type
  title: string,                    // Message title
  content: string,                  // Message content
  actions?: Array<{                 // Optional action buttons
    label: string,                  // Button label
    value: string                   // Value returned when clicked
  }>,
  timeout?: number                  // Optional timeout in milliseconds
}

Advanced Usage

Notification

A simple message that does not require a response.

{
  "type": "notification",
  "title": "Hello",
  "content": "This is a notification"
}

Prompt

A message that waits for a response.

{
  "type": "prompt",
  "title": "Question",
  "content": "Do you want to continue?",
  "actions": [
    { "label": "Yes", "value": "yes" },
    { "label": "No", "value": "no" }
  ],
  "timeout": 60000  // Optional: 1 - minute timeout
}

⚠️ Important Note

• Prompts can be answered by clicking an action button or sending a text message.
• Each prompt only accepts one response.
• If a timeout is set, the prompt will fail after the timeout.
• Notifications do not wait for a response and return immediately.