Discord

What is Discord MCP Server?

Discord MCP Server is a Model Context Protocol (MCP) server that facilitates interaction between Large Language Models (LLMs) like Claude and Discord channels. It enables LLMs to send and read messages within Discord, ensuring user control and security.

How to use Discord MCP Server?

To use Discord MCP Server, you need Node.js (16.x or higher) and a Discord bot token. After cloning the repository and installing dependencies, create a .env file with your Discord bot token. Then, build the server using npm run build. For integration with Claude for Desktop, you need to configure claude_desktop_config.json to include the Discord MCP server, specifying the command to run the server and your Discord bot token as an environment variable. After setup, LLMs can utilize the send-message and read-messages tools to interact with Discord.

Key Features of Discord MCP Server

• Message Sending: Send messages to specified Discord channels.
• Message Reading: Read recent messages from Discord channels.
• Automatic Discovery: Automatic server and channel discovery.
• Flexible Addressing: Support for both channel names and IDs.
• Robust Handling: Proper error handling and validation.

Use Cases of Discord MCP Server

• Automated Responses: LLMs can provide automated responses in Discord channels.
• Information Retrieval: LLMs can fetch and summarize information from Discord conversations.
• Interactive Bots: Create interactive bots that can engage in conversations and perform actions within Discord.
• Content Generation: LLMs can generate and post content directly to Discord channels.

FAQ about Discord MCP Server

Q: What are the prerequisites for running Discord MCP Server? A: You need Node.js 16.x or higher, a Discord bot token, and the bot must have specific permissions (Read Messages/View Channels, Send Messages, Read Message History) in your Discord server.

Q: How do I configure Discord MCP Server with Claude for Desktop? A: You need to modify the mcpServers section in your Claude for Desktop configuration file (claude_desktop_config.json) to include the Discord MCP server's command and environment variables.

Q: What tools are available for LLMs to interact with Discord? A: The send-message tool allows LLMs to send messages, and the read-messages tool enables them to read recent messages from Discord channels.

Q: What security considerations should I be aware of? A: Ensure proper Discord permissions for the bot, require explicit user approval for message sending, secure environment variables, never commit your bot token to version control, and understand that channel access is limited to what the bot has been granted.

Discord MCP Server

A Model Context Protocol (MCP) server that enables LLMs to interact with Discord channels, allowing them to send and read messages through Discord's API. Using this server, LLMs like Claude can directly interact with Discord channels while maintaining user control and security.

Features

• Send messages to Discord channels
• Read recent messages from channels
• Automatic server and channel discovery
• Support for both channel names and IDs
• Proper error handling and validation

Prerequisites

• Node.js 16.x or higher
• A Discord bot token
• The bot must be invited to your server with proper permissions:
  • Read Messages/View Channels
  • Send Messages
  • Read Message History

Setup

1. Clone this repository:

git clone https://github.com/yourusername/discordmcp.git
cd discordmcp

2. Install dependencies:

npm install

3. Create a .env file in the root directory with your Discord bot token:

DISCORD_TOKEN=your_discord_bot_token_here

4. Build the server:

npm run build

Usage with Claude for Desktop

1. Open your Claude for Desktop configuration file:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Add the Discord MCP server configuration:

{
  "mcpServers": {
    "discord": {
      "command": "node",
      "args": ["path/to/discordmcp/build/index.js"],
      "env": {
        "DISCORD_TOKEN": "your_discord_bot_token_here"
      }
    }
  }
}

3. Restart Claude for Desktop

Available Tools

send-message

Sends a message to a specified Discord channel.

Parameters:

• server (optional): Server name or ID (required if bot is in multiple servers)
• channel: Channel name (e.g., "general") or ID
• message: Message content to send

Example:

{
  "channel": "general",
  "message": "Hello from MCP!"
}

read-messages

Reads recent messages from a specified Discord channel.

Parameters:

• server (optional): Server name or ID (required if bot is in multiple servers)
• channel: Channel name (e.g., "general") or ID
• limit (optional): Number of messages to fetch (default: 50, max: 100)

Example:

{
  "channel": "general",
  "limit": 10
}

Development

1. Install development dependencies:

npm install --save-dev typescript @types/node

2. Start the server in development mode:

npm run dev

Testing

You can test the server using the MCP Inspector:

npx @modelcontextprotocol/inspector node build/index.js

Examples

Here are some example interactions you can try with Claude after setting up the Discord MCP server:

1. "Can you read the last 5 messages from the general channel?"
2. "Please send a message to the announcements channel saying 'Meeting starts in 10 minutes'"
3. "What were the most recent messages in the development channel about the latest release?"

Claude will use the appropriate tools to interact with Discord while asking for your approval before sending any messages.

Security Considerations

• The bot requires proper Discord permissions to function
• All message sending operations require explicit user approval
• Environment variables should be properly secured
• Token should never be committed to version control
• Channel access is limited to channels the bot has been given access to

Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Support

If you encounter any issues or have questions:

1. Check the GitHub Issues section
2. Consult the MCP documentation at https://modelcontextprotocol.io
3. Open a new issue with detailed reproduction steps