MCP-Relay

# 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](https://discord.com/developers/applications) 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: ```json { "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: ```typescript { 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 ```json { "type": "notification", "title": "Hello", "content": "This is a notification" } ``` 2. **Prompt**: Message that waits for a response ```json { "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