What is Mcp Relay

MCP-Relay is a server that facilitates communication between Claude and a Discord channel, allowing messages and prompts to be sent and responses to be received seamlessly.

Use cases

Use cases for MCP-Relay include automating responses in Discord channels, facilitating discussions between users and bots, and integrating external services with Discord for enhanced user engagement.

How to use

To use MCP-Relay, you need to create a Discord application and bot, invite the bot to your server, obtain the channel ID, and configure the MCP settings with the bot token and channel ID in your MCP settings file.

Key features

Key features of MCP-Relay include the ability to send and receive messages in real-time, integration with Discord’s API, and support for various bot permissions to enhance functionality.

Where to use

MCP-Relay can be used in various fields such as community management, customer support, and interactive applications where real-time communication is essential.

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

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