Discord MCP Server

⚠️ SECURITY WARNING: This project handles Discord bot tokens and server access. Please read our Security Policy before using or contributing.

A comprehensive Model Context Protocol (MCP) server for Discord API integration, providing powerful Discord bot management capabilities through a standardized interface.

Features

This server provides 93 Discord tools organized into the following categories:

Key Tools

• discord_manage - Unified tool that handles all 93 operations through one interface
• comprehensive_channel_management - Multi-operation channel orchestrator
• bulk_set_privacy - Mass privacy control across channels/categories
• organize_channels - Advanced channel/category positioning system
• export_chat_log - Professional chat export in JSON/CSV/TXT formats

Quick Start

Prerequisites

• Node.js 18+ and npm
• Discord bot token (see setup below)

Installation

# Clone the repository
git clone https://github.com/sashathelambo/discord-mcp.git
cd discord-mcp

# Install dependencies
npm install

# Build the project
npm run build

# Start the server
npm start

Development Mode

npm run dev

Configuration

Discord Bot Setup

1. Go to Discord Developer Portal
2. Create a new application and bot
3. Copy the bot token to your .env file
4. IMPORTANT: Regenerate your token if you suspect it's been exposed

Environment Variables

Create a .env file:

# Your Discord bot token (KEEP SECRET!)
DISCORD_TOKEN=your_bot_token_here

# Default Discord server ID (optional)
DISCORD_GUILD_ID=your_guild_id_here

Required Bot Permissions

Manage Server
Manage Roles  
Manage Channels
Manage Messages
View Channels
Send Messages
Connect (for voice)
Speak (for voice)

Usage

MCP Integration

Use with MCP-compatible clients:

# Via stdio
npx discord-mcp

# Via HTTP (port 3001)
HTTP_PORT=3001 npx discord-mcp

Examples

Using the Master Control Tool

// All operations through one unified interface
await discord_manage({
  action: 'send_message',
  channelId: '123',
  message: 'Hello World!'
});

await discord_manage({
  action: 'create_text_channel',
  guildId: '456',
  name: 'new-channel'
});

await discord_manage({
  action: 'comprehensive_channel_management',
  guildId: '456',
  operations: [
    { action: 'create_category', name: 'New Category' },
    { action: 'create_text_channel', name: 'general', categoryId: 'cat_id' },
    { action: 'set_channel_private', channelId: 'chan_id', isPrivate: true }
  ]
});

Using Individual Tools

// Server information
await discord.getServerInfo(guildId);

// Advanced channel creation
await discord.createForumChannel(guildId, "discussions", categoryId, {
  topic: "Community discussions",
  slowmode: 30,
  isPrivate: true,
  allowedRoles: ["member_role_id"]
});

// Bulk privacy management
await discord.bulkSetPrivacy(guildId, {
  targets: [
    { id: "channel1", type: "channel", isPrivate: true },
    { id: "category1", type: "category", isPrivate: false }
  ]
});

// Export chat logs
await discord.exportChatLog(channelId, "JSON", {
  limit: 1000,
  dateRange: { start: "2024-01-01", end: "2024-12-31" }
});

Security

For Users

• Keep your Discord bot token secret
• Regularly rotate your tokens
• Monitor bot activity
• Use minimal required permissions

For Contributors

• Never commit tokens or secrets
• Validate all user inputs
• Review dependencies for vulnerabilities
• Follow secure coding practices

Tool Reference

Contributing

Project Creator & Lead Developer: @sashathelambo (Dr. Vova)

This project is primarily developed and maintained by sashathelambo. For contributions:

1. Read our Contributing Guidelines
2. Follow our Security Policy
3. Use the PR template
4. Test thoroughly before submitting
5. Discuss major changes with @sashathelambo first

Development Guidelines

• Use TypeScript for all code
• Follow existing code style
• Add tests for new features
• Never commit sensitive data
• Update documentation

Troubleshooting

Common Issues

• Token Invalid: Regenerate your Discord bot token
• Permission Denied: Check bot permissions in Discord server
• Build Errors: Ensure Node.js 18+ and TypeScript are installed

Getting Help

• Check our documentation
• Report bugs
• Request features
• Join our community discussions

License

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

Disclaimer

This software is provided "as-is" without warranty. Users are responsible for:

• Complying with Discord's Terms of Service
• Securing their bot tokens and credentials
• Using appropriate permissions and rate limiting
• Monitoring and maintaining their Discord bots

Acknowledgments

• @sashathelambo (Dr. Vova) - Project creator, lead developer, and architect of all 93 Discord tools
• Discord.js team for the excellent Discord API wrapper
• Model Context Protocol community for the standardized protocol
• Everyone who uses and supports this project