MCP Relay

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

Setup Instructions

1. Create a Discord Application and Bot

Go to the Discord Developer Portal
Click "New Application" and give it a name
Go to the "Bot" section in the left sidebar
Under the bot's token section, click "Reset Token" and copy the new token
- Keep this token secure! Don't share it publicly
Under "Privileged Gateway Intents", enable:
- Message Content Intent
- Server Members Intent
- Presence Intent

2. Invite the Bot to Your Server

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

3. Get Channel ID

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

4. Configure MCP Settings

The server requires configuration 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 Discord bot token
your_channel_id_here with your Discord channel ID

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

Usage

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

{
  type: 'prompt' | 'notification',  // Type of message
  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
}

Message Types

Notification: Simple message that doesn't expect a response
{ "type": "notification", "title": "Hello", "content": "This is a notification" }
Prompt: Message that waits for a response
{ "type": "prompt", "title": "Question", "content": "Do you want to proceed?", "actions": [ { "label": "Yes", "value": "yes" }, { "label": "No", "value": "no" } ], "timeout": 60000 // Optional: 1 minute timeout }

Notes:

Prompts can be answered either by clicking action buttons or sending a text message
Only one response is accepted per prompt
If a timeout is specified, the prompt will fail after the timeout period
Notifications don't wait for responses and return immediately