Discord MCP Server
A Model Context Protocol (MCP) server that provides Discord functionality to AI assistants and applications.
에이전트 강화
게시자가 제공하는 설치 방식입니다. PlugMCP 엔드포인트가 아닙니다.
원격 URL인가요, 내 컴퓨터에서 실행하는 명령인가요? 두 설치 방식의 차이
PlugMCP에서 실행
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
실행게시자 제공
A Model Context Protocol (MCP) server that provides Discord functionality to AI assistants and applications.
Enable AI agents to interact with Discord using this Model Context Protocol (MCP) server. Provides a full suite of tools and real-time event streams for the Discord API.
The server exposes a set of tools that can be called by an MCP client. These tools provide a way to interact with the Discord API in a structured manner.
ping: Checks the health of the server and the connection to Discord.get_guild_info: Get information about a specific Discord server (guild).list_guild_members: List all members in a Discord server (guild).list_channels: List channels in a Discord server (guild).get_channel_info: Get information about a specific Discord channel.send_message: Sends a message to a Discord channel with support for embeds, replies, and TTS.get_channel_messages: Retrieves message history from a Discord channel with pagination support.edit_message: Edits a Discord message's content or embeds.delete_message: Deletes a Discord message.add_reaction: Adds an emoji reaction to a Discord message.list_roles: Lists all roles in a Discord server (guild).get_role_info: Get information about a specific Discord role.create_role: Creates a new role in a Discord server (guild).delete_role: Deletes a role in a Discord server (guild).assign_role: Assigns a role to a user in a Discord server (guild).unassign_role: Unassigns a role from a user in a Discord server (guild).Beyond the tool-based interaction, the server can stream real-time events from Discord directly to the MCP client. This is achieved through JSON-RPC notifications, allowing for proactive and responsive applications.
When a configured Discord event occurs, the server sends a notification like this:
{
"jsonrpc": "2.0",
"method": "discord/messageCreated",
"params": {
"guild_id": "123456789012345678",
"channel_id": "234567890123456789",
"message_id": "345678901234567890",
"author_id": "456789012345678901",
"content": "Hello, world!"
}
}
discord/messageCreated: A new message is sent in a channel.discord/guildMemberAdded: A new user joins the guild.discord/messageReactionAdded: A reaction is added to a message.Event streaming can be enabled and filtered in config.yaml.
Build:
go mod tidy
go build -o discord-mcp ./cmd/discord-mcp
Create configuration:
cp config.yaml.example config.yaml
# Edit config.yaml with your Discord bot token
Run the server:
./discord-mcp
Or with environment variable:
DISCORD_TOKEN=your_bot_token_here ./discord-mcp
To use all available tools, your bot will need the appropriate permissions in your Discord server's roles settings, as well as the correct Gateway Intents enabled in the Developer Portal.
Note: Granting the Administrator permission will cover all permission requirements, but is not recommended for production bots.
config.yaml)discord:
token: "YOUR_BOT_TOKEN_HERE"
guild_id: "" # Optional default guild
allowed_guilds: [] # Restrict to specific guilds
max_message_length: 2000 # Discord's limit
rate_limit_per_minute: 30 # Rate limiting
mcp:
server_name: "discord-mcp"
version: "1.0.0"
events:
enabled: true # Master switch for all events
allowed_events: # List of events to stream
- "discord/messageCreated"
- "discord/guildMemberAdded"
- "discord/messageReactionAdded"
server:
log_level: "info" # debug, info, warn, error
debug: false
DISCORD_TOKEN - Discord bot token (overrides config)DISCORD_GUILD_ID - Default guild IDLOG_LEVEL - Log level./discord-mcp [options]
Options:
-config string
Path to configuration file (default "config.yaml")
-log-level string
Log level (debug, info, warn, error)
-version
Show version and exit
The server supports two primary modes of interaction with an MCP client: synchronous tool calls (request/response) and asynchronous event streaming (notifications).
For clients that need to execute specific actions on demand, the server acts as a standard JSON-RPC tool provider. The client sends a tools/call request, and the server responds with the result.
Example Session:
// --> Client sends initialize request
{"jsonrpc": "2.0", "id": 1, "method": "initialize", "params": {"protocolVersion": "2024-11-05", "clientInfo": {"name": "test-client", "version": "1.0.0"}}}
// <-- Server responds with its capabilities
{"jsonrpc": "2.0", "id": 1, "result": {"protocolVersion": "1.0.0", "serverInfo": {"name": "discord-mcp"}}}
// --> Client asks to send a message
{"jsonrpc": "2.0", "id": 2, "method": "tools/call", "params": {"name": "send_message", "arguments": {"channel_id": "1234567890", "content": "Hello from my AI assistant!"}}}
// <-- Server confirms the message was sent and returns its details
{"jsonrpc": "2.0", "id": 2, "result": {"message_id": "9876543210", "content": "Hello from my AI assistant!", "author_id": "bot-id-here"}}
For clients that need to react to events in real-time, the server can be configured to stream Discord events as JSON-RPC notifications. This is optional and can be enabled via the events section in config.yaml.
When a subscribed event occurs on Discord, the server will send an unsolicited notification to the client. The client should be prepared to listen for these messages at any time after initialization.
Example Notification:
Here is an example of a notification the client might receive when a new user joins the server. Note that it has no id field, as it is not a response to a request.
// <-- Server sends a notification about a new member
{
"jsonrpc": "2.0",
"method": "discord/guildMemberAdded",
"params": {
"guild_id": "123456789012345678",
"user": {
"id": "543210987654321098",
"username": "new-user"
}
}
}
The server uses two different structures for error responses, depending on the nature of the error.
Protocol-Level Errors: For issues related to the JSON-RPC protocol itself (e.g., a malformed request or a method that doesn't exist), the server returns a standard top-level error object, as defined by the JSON-RPC 2.0 specification.
{
"jsonrpc": "2.0",
"id": 1,
"error": {
"code": -32601,
"message": "Method not found: non_existent_method"
}
}
Application-Level Errors: For errors that occur within the application's logic (e.g., a tool fails, a resource is not found, or the server is not yet initialized), the error is returned inside the result object. This is to accommodate specific client-side validators.
// Error when calling "tools/list" before the server is initialized
{
"jsonrpc": "2.0",
"id": 2,
"result": {
"isError": true,
"content": [
{
"type": "text",
"text": "Server not initialized"
}
]
}
}
For more detailed, end-to-end scenarios showing how to combine these patterns, see our Real-World Usage Examples.
For a guide on how to use the MCP server with Claude Desktop, please see the Claude Desktop Guide.
discord-mcp/
├── cmd/discord-mcp/ # Main application entry point
├── internal/
│ ├── config/ # Configuration management
│ ├── discord/ # Discord API client wrapper
│ ├── handlers/ # MCP tool handlers
│ ├── mcp/ # MCP server implementation
│ └── notifications/ # Event notification service
├── pkg/types/ # Shared types and interfaces
├── config.yaml.example # Example configuration
├── go.mod # Go module definition
└── README.md # This file
go build -o discord-mcp ./cmd/discord-mcp
go test ./...
internal/handlers/.ToolHandler interface:
type ToolHandler interface {
Execute(params types.CallToolParams) (types.CallToolResult, error)
GetDefinition() types.Tool
}
cmd/discord-mcp/main.go.Find the event in discordgo: Identify the event you want to handle from the bwmarrin/discordgo library (e.g., *discordgo.ChannelCreate).
Create a handler in internal/discord/dispatcher.go: Add a new Handle... method to the EventDispatcher.
func (d *EventDispatcher) HandleChannelCreate(s *discordgo.Session, e *discordgo.ChannelCreate) {
// 1. Check if event is enabled
if !d.config.Enabled || !d.isEventAllowed("discord/channelCreated") {
return
}
// 2. Construct parameters
params := map[string]interface{}{
"guild_id": e.GuildID,
"channel_id": e.ID,
"name": e.Name,
"type": e.Type,
}
// 3. Create and send notification
notification := d.createNotification("discord/channelCreated", params)
if err := d.notificationSvc.Send(notification); err != nil {
d.logger.Errorf("Failed to send channelCreated notification: %v", err)
}
}
Register the handler in internal/discord/client.go: In the SetupEventHandlers function, add the new handler to the session.
c.session.AddHandler(c.dispatcher.HandleChannelCreate)
Update configuration: Add the new event name (discord/channelCreated) to the allowed_events list in config.yaml.example so users know it's available.
Run with debug logging:
./discord-mcp -log-level debug
allowed_guilds configuration"Discord token is required"
"Failed to connect to Discord"
Rate limit exceeded
rate_limit_per_minute in configurationTool execution fails
-log-level debugThe server provides comprehensive logging:
This project is licensed under the MIT License - see the LICENSE file for details.
This roadmap is prioritized by business impact.
get tools (e.g., list banned users).Enable AI agents to interact with Discord using this Model Context Protocol (MCP) server. Provides a full suite of tools and real-time event streams for the Discord API.
도구
아직 도구 목록이 없습니다. 원격 서버는 첫 상태 확인 후에 도구 목록이 생깁니다.
FAQ
이 페이지에서 Cursor, Claude Desktop, Claude Code 또는 VS Code용 stdio 설정을 복사합니다. PlugMCP 프록시가 아니라 게시자의 설치 방식을 사용합니다.
이 레코드에는 필수 환경 변수가 등록되어 있지 않습니다.
Discord은(는) stdio를 통해 로컬에서 실행됩니다.
마지막 확인: 2026-10-27. Enable AI agents to interact with Discord using this Model Context Protocol (MCP) server. Provides a full suite of tools and real-time event streams for the Discord API.