MCP-Relay

MCP-Relay

1
communication

MCP Relay is an MCP server designed for integrating communication between Claude and Discord, allowing for the exchange of messages and prompts with response handling. Its features include configuring message settings and permissions to facilitate seamless interaction with a Discord channel.

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

  1. Go to the Discord Developer Portal
  2. Click "New Application" and give it a name
  3. Go 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! Don't share it publicly
  5. Under "Privileged Gateway Intents", enable:
    • Message Content Intent
    • Server Members Intent
    • Presence Intent

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

3. Get Channel ID

  1. In Discord, enable Developer Mode:
    • Go to User Settings > App Settings > Advanced
    • Turn on "Developer Mode"
  2. Right-click the channel you want to use
  3. 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

  1. Notification: Simple message that doesn't expect a response

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

  2. 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