https://github.com/mastra-ai/discord-mcp-server
https://github.com/mastra-ai/discord-mcp-server
Last synced: 28 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/mastra-ai/discord-mcp-server
- Owner: mastra-ai
- Created: 2025-03-25T19:17:12.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-03-26T18:01:55.000Z (7 months ago)
- Last Synced: 2025-07-06T13:41:14.252Z (3 months ago)
- Language: TypeScript
- Size: 32.2 KB
- Stars: 1
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Discord MCP Bot - Server Component
A Discord bot server that integrates with [Mastra's MCP Bot component](https://github.com/mastra-ai/discord-mcp-bot) to provide intelligent assistance and answer questions about Mastra.ai.
## Overview
This Discord bot server works with the Mastra MCP component to:
- Handle Discord interactions and message routing
- Manage bot commands and permissions
- Provide Discord-specific functionality like threads and DMs
- Interface with the Mastra component for intelligent responses
## Prerequisites
- Node.js v20.0+
- npm
- Discord bot token
- Access to [discord-mcp-bot](https://github.com/mastra-ai/discord-mcp-bot) component
## Getting Started
1. Clone the repository:
```bash
git clone https://github.com/mastra-ai/discord-mcp-server
cd discord-mcp-server
```
2. Install dependencies:
```bash
npm install
```
3. Create a `.env` file with your Discord credentials:
```
DISCORD_BOT_TOKEN=your_discord_bot_token
DISCORD_CLIENT_ID=your_discord_client_id
DISCORD_PUBLIC_KEY=your_discord_public_key
MASTRA_URL=your_mastra_url
```
4. Run the server:
```bash
npm start
```
## Setting Up a Discord Bot
1. Create a Discord application:
- Go to [Discord Developer Portal](https://discord.com/developers/applications)
- Click "New Application" and give it a name
- Navigate to the "Bot" tab and click "Add Bot"
2. Configure bot permissions:
- Under "Privileged Gateway Intents", enable:
- Message Content Intent
- Server Members Intent
- Direct Message Intent
3. Get your bot token:
- In the Bot tab, click "Reset Token" or "Copy" to get your bot token
- Add this token to your `.env` file as `DISCORD_BOT_TOKEN`
4. Invite the bot to your server:
- Go to the "OAuth2" tab, then "URL Generator"
- Select "bot" under scopes
- Select required permissions:
- Read Messages/View Channels
- Send Messages
- Read Message History
- Copy the generated URL and open it in your browser
- Select your server and authorize the bot
## Features
- **Direct Message Support**: Users can DM the bot to ask questions
- **Slash Commands**: Uses Discord's slash commands to interact with the bot
- `/ask`: Ask the bot a question
- `/cleardm`: Clear the bot messages in the user's DMs
- **Threads**: Uses Discord's threads to provide a better user experience
- **Integration**: Seamless integration with the Mastra MCP component
## Project Structure
- `api/index.ts`: Main bot implementation and Discord client setup
- `scripts/register-commands.ts`: Register the bot commands
- `scripts/delete-commands.ts`: Delete the bot commands
- `scripts/list-commands.ts`: List the bot commands
## Implementation Notes
The server is built with:
- Discord.js for Discord integration
- TypeScript for type safety and better development experience
- Integration with Mastra MCP component for intelligent responses
For production deployment, consider:
- Setting up proper logging
- Implementing rate limiting
- Adding monitoring and error tracking
- Setting up a process manager (PM2, etc.)
## Related Projects
- [discord-mcp-bot](https://github.com/mastra-ai/discord-mcp-bot): Handles Mastra-specific functionality and intelligent responses