convez.ai
MCP ServerAutomaçãoIntermediário
PaSympa

Discord MCP Server

PaSympa/discord-mcp

Controle Discord via Claude — 95+ ferramentas para automação e moderação

Ver no GitHub
BomPluginScore · de 0 a 100

Servidor MCP que integra Discord com Claude e outros clientes MCP, permitindo gerenciar mensagens, canais, roles, permissões, moderação e webhooks via linguagem natural. Fornece 95+ ferramentas para automação e controle completo de servidores Discord diretamente de IDEs e assistentes de IA.

Instalação

$npx convez-ai PaSympa/discord-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
38
Forks
21
Acompanhando
1
Saúde
71%
Último commit
há 2 dias
Versão
v2.4.0
Issues abertas
7
Contribuidores
4

Casos de uso

  • Automação de moderação em servidores Discord grandes
  • Gerenciamento de canais, roles e permissões via linguagem natural
  • Criação e envio de mensagens/embeds programaticamente
  • Integração de bots Discord com fluxos de IA e automação

Veredito

Solução robusta e leve para automação Discord multi-servidor com 95+ ferramentas. Excelente integração com ecossistema Claude/MCP, instalação simples via npx, mas requer conhecimento de tokens de bot e setup inicial de configuração.

README

A tradução para o português deste README ainda está na fila.

Discord MCP Server

A lightweight, multi-guild Discord MCP server with 95+ tools

npm License Node Discord.js MCP

discord-mcp MCP server

Manage your entire Discord server from Claude Desktop, Claude Code, Cursor, VS Code Copilot, or any MCP-compatible client. Messages, channels, roles, permissions, moderation, forums, webhooks — all through natural language.


Why this one?

  • 95+ tools — messages, channels, roles, permissions, moderation, forums, webhooks, scheduled events, invites, DMs, embeds, and more
  • Multi-guild — works across multiple servers, no GUILD_ID lock-in
  • Lightweight — TypeScript + Node.js, ~25kB package, ~73MB Docker image (vs 400MB+ for Java alternatives)
  • Modular — clean architecture, easy to extend with new tools
  • Two install methods — npm or Docker, your choice

Quick Start

Add this to your MCP client config and replace YOUR_TOKEN_HERE with your bot token:

{
  "mcpServers": {
    "discord": {
      "command": "npx",
      "args": ["-y", "@pasympa/discord-mcp"],
      "env": {
        "DISCORD_TOKEN": "YOUR_TOKEN_HERE"
      }
    }
  }
}

No install needed — npx handles everything.

Don't have a bot yet? See Creating Your Discord Bot.


Configuration

Add the config above to your claude_desktop_config.json:

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

Restart Claude Desktop after saving.

claude mcp add discord -e DISCORD_TOKEN=YOUR_TOKEN_HERE -- npx -y @pasympa/discord-mcp

Add the config above to ~/.cursor/mcp.json. See Cursor MCP docs for details.

Add to your .vscode/mcp.json:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "discord-token",
      "description": "Discord Bot Token",
      "password": true
    }
  ],
  "servers": {
    "discord": {
      "command": "npx",
      "args": ["-y", "@pasympa/discord-mcp"],
      "env": {
        "DISCORD_TOKEN": "${input:discord-token}"
      }
    }
  }
}

See VS Code MCP docs for details.

{
  "mcpServers": {
    "discord": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-e", "DISCORD_TOKEN=YOUR_TOKEN_HERE",
        "pasympa/discord-mcp:latest"
      ]
    }
  }
}
git clone https://github.com/PaSympa/discord-mcp
cd discord-mcp
npm install && npm run build
{
  "mcpServers": {
    "discord": {
      "command": "node",
      "args": ["/absolute/path/to/discord-mcp/dist/index.js"],
      "env": {
        "DISCORD_TOKEN": "YOUR_TOKEN_HERE"
      }
    }
  }
}

Instead of passing the token in the MCP config, create a .env file at the project root:

DISCORD_TOKEN=YOUR_TOKEN_HERE

The server loads .env automatically via dotenv.


Creating Your Discord Bot

  1. Go to discord.com/developers/applications
  2. New Application > give it a name
  3. Bot tab > Reset Token > copy the token
  4. Enable Privileged Gateway Intents:
    • Server Members Intent
    • Message Content Intent
  5. OAuth2 > URL Generator:
    • Scopes: bot
    • Permissions: Send Messages, Read Message History, Manage Channels, Manage Roles, Kick Members, Ban Members, Moderate Members, View Audit Log, Manage Messages, Manage Threads, Add Reactions, Manage Guild, Manage Webhooks, Manage Events, Create Instant Invite
  6. Copy the generated URL and invite the bot to your server

Available Tools (97)

Discovery & Navigation (4 tools)

ToolDescription
discord_list_guildsList all servers the bot is connected to
discord_get_guild_infoGet detailed guild info (name, members, channels, roles, boosts)
discord_list_channelsList all channels in a guild grouped by category
discord_find_channel_by_nameFind a channel by name (partial match)

Messages (18 tools)

ToolDescription
discord_read_messagesRead the last N messages from a text channel
discord_send_messageSend a plain text message
discord_reply_messageReply to a specific message
discord_edit_messageEdit a message sent by the bot
discord_delete_messageDelete a specific message
discord_add_reactionAdd a reaction emoji to a message
discord_remove_reactionsRemove reactions (all, by emoji, or by user)
discord_get_reactionsList users who reacted with a specific emoji
discord_create_threadCreate a thread from a message or standalone
discord_bulk_delete_messagesDelete multiple messages at once (2-100)
discord_send_embedSend a rich embed with all options
discord_edit_embedEdit an embed previously sent by the bot
discord_send_multiple_embedsSend up to 10 embeds in a single message
discord_pin_messagePin or unpin a message
discord_fetch_pinned_messagesList all pinned messages in a channel
discord_search_messagesSearch messages by keyword (last 100)
discord_crosspost_messagePublish a message to announcement channel followers
discord_forward_messageForward a message to another channel

Channels (8 tools)

ToolDescription
discord_create_channelCreate a text, voice channel or category
discord_delete_channelDelete a channel
discord_edit_channelEdit name, topic, slowmode, NSFW flag
discord_move_channelMove a channel into/out of a category
discord_clone_channelClone a channel with its permissions
discord_set_channel_positionSet display position within a category
discord_follow_announcement_channelFollow an announcement channel
discord_lock_channel_permissionsSync permissions with parent category

Channel Permissions (6 tools)

ToolDescription
discord_get_channel_permissionsList all permission overwrites on a channel
discord_set_role_permissionAllow/deny permissions for a role on a channel
discord_set_member_permissionAllow/deny permissions for a member on a channel
discord_reset_channel_permissionsRemove all overwrites (reset to inherited)
discord_copy_permissionsCopy overwrites from one channel to another
discord_audit_permissionsFull permission audit for all channels

Members (11 tools)

ToolDescription
discord_list_membersList guild members with their roles
discord_get_member_infoDetailed member info (roles, permissions, join date)
discord_search_membersSearch members by username or nickname
discord_set_nicknameSet or clear a member's nickname
discord_kick_memberKick a member
discord_ban_memberBan a member (optionally delete recent messages)
discord_unban_memberUnban a user
discord_bulk_banBan multiple users at once (raid mitigation)
discord_list_bansList all banned users
discord_timeout_memberTimeout a member (0 to remove)
discord_prune_membersRemove inactive members (with dry run)

Roles (9 tools)

ToolDescription
discord_list_rolesList all roles with permissions and member count
discord_create_roleCreate a new role
discord_edit_roleEdit a role (name, color, permissions, hoist, mentionable)
discord_delete_roleDelete a role
discord_add_roleAssign a role to a member
discord_remove_roleRemove a role from a member
discord_get_role_membersList all members with a specific role
discord_set_role_positionChange a role's position in the hierarchy
discord_set_role_iconSet a custom icon or unicode emoji on a role

Forums (10 tools)

ToolDescription
discord_get_forum_channelsList all forum channels in a guild
discord_create_forum_channelCreate a new forum channel
discord_create_forum_postCreate a post/thread in a forum
discord_get_forum_postGet a post's details and messages
discord_list_forum_threadsList threads (active + archived)
discord_reply_to_forumReply to a forum post
discord_delete_forum_postDelete a forum thread
discord_get_forum_tagsGet available tags
discord_set_forum_tagsSet/update tags on a forum
discord_update_forum_postUpdate title, archived, locked, tags

Webhooks (8 tools)

ToolDescription
discord_create_webhookCreate a webhook on a channel
discord_send_webhook_messageSend via webhook (custom username/avatar, embeds)
discord_edit_webhookEdit a webhook's name, avatar, or channel
discord_delete_webhookDelete a webhook
discord_list_webhooksList webhooks for a channel or guild
discord_edit_webhook_messageEdit a message sent by a webhook
discord_delete_webhook_messageDelete a message sent by a webhook
discord_fetch_webhook_messageFetch a specific webhook message

Scheduled Events (7 tools)

ToolDescription
discord_list_scheduled_eventsList all scheduled events in a guild
discord_get_scheduled_eventGet detailed info about a scheduled event
discord_create_scheduled_eventCreate a voice, stage, or external event
discord_edit_scheduled_eventEdit an existing scheduled event
discord_delete_scheduled_eventDelete a scheduled event
discord_get_event_subscribersGet users who marked "Interested"
discord_create_event_inviteCreate an invite linked to an event

Direct Messages (7 tools)

ToolDescription
discord_send_dmSend a direct message to a user by their user ID
discord_send_dm_embedSend an embed in a DM to a user
discord_read_dmsRead message history from a DM conversation
discord_reply_dmReply to a specific DM message
discord_edit_dmEdit a previously sent DM (text)
discord_edit_dm_embedEdit a previously sent DM embed
discord_delete_dmDelete a DM message

Invites (5 tools)

ToolDescription
discord_list_invitesList all active invites in a guild
discord_list_channel_invitesList invites for a specific channel
discord_get_inviteGet details about an invite by its code
discord_create_inviteCreate an invite link for a channel
discord_delete_inviteRevoke an invite

Moderation & Screening (3 tools)

ToolDescription
discord_get_audit_logFetch the guild audit log
discord_get_membership_screeningGet the membership screening form
discord_update_membership_screeningUpdate screening rules for new members

Stats (1 tool)

ToolDescription
discord_get_server_statsServer stats: members, channels, roles, boost level

Usage Examples

"List all servers the bot is in"
"Read the last 10 messages in #general"
"Send 'Hello everyone!' to the announcements channel"
"Create a forum channel called 'feedback' with tags Bug, Feature, Question"
"Show the full permission audit for the server"
"Create a webhook on #notifications and send a test message"
"Ban user 112233445566 and delete their messages from the last 3 days"
"Create an event called 'Game Night' for next Friday at 8pm"
"List all upcoming events in the server"
"Create a permanent invite for #general"
"List all active invites and delete expired ones"
"Send a DM to user 112233445566 saying 'Your build passed!'"
"Search for members named 'john'"
"List all banned users in the server"
"Show all pinned messages in #general"
"Forward that message to #announcements"

Finding Discord IDs

Enable Developer Mode in Discord: Settings > Advanced > Developer Mode

Then right-click on a server, channel, or user > Copy ID.


Project Structure

discord-mcp/
├── src/
│   ├── index.ts             ← Entry point (MCP server + transport)
│   ├── client.ts            ← Discord client + shared helpers
│   ├── constants.ts         ← Shared constants (limits, defaults)
│   └── tools/
│       ├── index.ts         ← Tool registry
│       ├── types.ts         ← Shared TypeScript interfaces
│       ├── discovery.ts     ← Guild/channel discovery
│       ├── messages.ts      ← Message CRUD, reactions, threads, embeds
│       ├── channels.ts      ← Channel management
│       ├── permissions.ts   ← Permission overwrites
│       ├── members.ts       ← Member management
│       ├── roles.ts         ← Role CRUD and assignment
│       ├── moderation.ts    ← Audit log
│       ├── screening.ts     ← Membership screening
│       ├── stats.ts         ← Server statistics
│       ├── forums.ts        ← Forum channels, posts, tags
│       ├── webhooks.ts      ← Webhook management
│       ├── scheduledEvents.ts ← Scheduled events
│       ├── invites.ts        ← Invite management
│       └── dm.ts             ← Direct messages
├── .github/workflows/       ← CI/CD (build check + auto release)
├── Dockerfile
├── .dockerignore
├── .env.example
├── package.json
├── tsconfig.json
├── CHANGELOG.md
├── CONTRIBUTING.md
├── SECURITY.md
└── README.md

Adding a new tool

  1. Create a new file in src/tools/ (e.g. events.ts)
  2. Export definitions (tool schemas) and handle() (tool logic)
  3. Import and add it to the modules array in src/tools/index.ts

Security

  • Never commit your Discord token to Git
  • Use environment variables or a .env file (not versioned)
  • Give the bot only the permissions it needs

Contributing

Contributions are welcome!

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/my-feature)
  3. Follow the modular structure — see Adding a new tool
  4. Commit your changes and open a pull request

License

MIT — see LICENSE for details.

Ver o original no GitHub

Bom para

Relacionados