Content
# Discord Creator MCP
Serwer MCP do zarządzania serwerem Discord przez AI. Umożliwia pełną konfigurację serwera — kanały, kategorie, role, uprawnienia, członkowie, emoji, stickery, webhooky, wydarzenia, AutoMod, szablony i audyt — za pomocą dowolnego klienta AI obsługującego Model Context Protocol.
## Wymagania
- Node.js 18+
- Bot Discord z odpowiednimi uprawnieniami
## Tworzenie bota Discord
1. Wejdź na https://discord.com/developers/applications
2. Kliknij **New Application** i nadaj nazwę
3. Przejdź do **Bot** → skopiuj **Token**
4. W sekcji **Privileged Gateway Intents** włącz:
- **Server Members Intent**
- **Message Content Intent** (opcjonalnie)
5. Przejdź do **OAuth2 → URL Generator**:
- Scopes: `bot`
- Bot Permissions: `Administrator`
6. Skopiuj wygenerowany URL i dodaj bota do swojego serwera
## Instalacja
```bash
npm install
npm run build
```
## Konfiguracja
Skopiuj `.env.example` do `.env` i uzupełnij:
```
DISCORD_BOT_TOKEN=twój_token_bota
DISCORD_GUILD_ID=id_twojego_serwera
```
ID serwera uzyskasz włączając **Developer Mode** w Discordzie (Settings → Advanced), a następnie klikając prawym przyciskiem na nazwę serwera → **Copy Server ID**.
## Użycie z Claude Code / Claude Desktop
Dodaj do konfiguracji MCP (`claude_desktop_config.json` lub ustawienia Claude Code):
```json
{
"mcpServers": {
"discord-creator": {
"command": "node",
"args": ["ŚCIEŻKA/DO/discord-creator/dist/mcp-server.js"],
"env": {
"DISCORD_BOT_TOKEN": "twój_token",
"DISCORD_GUILD_ID": "twoje_guild_id"
}
}
}
}
```
## Dostępne narzędzia MCP (40+)
### Serwer
| Narzędzie | Opis |
|-----------|------|
| `get_server_info` | Informacje o serwerze |
| `modify_server` | Zmiana nazwy, opisu, poziomu weryfikacji itp. |
| `get_server_stats` | Szczegółowe statystyki (kanały wg typu, role, emoji...) |
### Kanały
| Narzędzie | Opis |
|-----------|------|
| `list_channels` | Lista wszystkich kanałów |
| `create_channel` | Tworzenie kanału (text, voice, announcement, forum, stage) |
| `delete_channel` | Usuwanie kanału |
| `modify_channel` | Modyfikacja kanału |
| `create_category` | Tworzenie kategorii |
| `set_channel_permissions` | Ustawianie uprawnień kanału |
| `bulk_create_channels` | Masowe tworzenie kanałów |
### Role
| Narzędzie | Opis |
|-----------|------|
| `list_roles` | Lista ról |
| `create_role` | Tworzenie roli z kolorami i uprawnieniami |
| `delete_role` | Usuwanie roli |
| `modify_role` | Modyfikacja roli |
### Członkowie
| Narzędzie | Opis |
|-----------|------|
| `list_members` | Lista członków z rolami |
| `assign_role` | Nadanie roli członkowi |
| `remove_role` | Odebranie roli |
| `kick_member` | Wyrzucenie członka |
| `ban_member` | Zbanowanie członka |
| `unban_member` | Odbanowanie |
| `timeout_member` | Timeout (wyciszenie) |
### Emoji i Stickery
| Narzędzie | Opis |
|-----------|------|
| `list_emojis` / `list_stickers` | Listy emoji i stickerów |
| `create_emoji` / `create_sticker` | Tworzenie z URL obrazu |
| `delete_emoji` / `delete_sticker` | Usuwanie |
| `modify_emoji` | Modyfikacja emoji |
### AutoMod
| Narzędzie | Opis |
|-----------|------|
| `list_automod_rules` | Lista reguł AutoMod |
| `create_automod_rule` | Tworzenie reguły (keyword, spam, mention spam...) |
| `delete_automod_rule` | Usuwanie reguły |
| `modify_automod_rule` | Modyfikacja reguły |
### Webhooky
| Narzędzie | Opis |
|-----------|------|
| `list_webhooks` | Lista webhooków |
| `create_webhook` | Tworzenie webhooka |
| `delete_webhook` | Usuwanie webhooka |
### Wiadomości
| Narzędzie | Opis |
|-----------|------|
| `pin_message` / `unpin_message` | Przypinanie/odpinanie wiadomości |
| `list_pinned_messages` | Lista przypiętych wiadomości |
### Wydarzenia
| Narzędzie | Opis |
|-----------|------|
| `list_events` | Lista zaplanowanych wydarzeń |
| `create_event` | Tworzenie wydarzenia (voice, stage, external) |
| `delete_event` | Usuwanie wydarzenia |
| `modify_event` | Modyfikacja wydarzenia |
### Szablony i backup
| Narzędzie | Opis |
|-----------|------|
| `export_server_structure` | Eksport struktury serwera do JSON |
| `import_server_structure` | Import struktury z JSON |
| `list_templates` | Lista wbudowanych szablonów |
| `apply_template` | Zastosowanie szablonu (gaming, community, company, school) |
### Audyt
| Narzędzie | Opis |
|-----------|------|
| `get_audit_log` | Przeglądanie audit logów |
| `compare_with_template` | Porównanie serwera z szablonem (drift detection) |
## Wbudowane szablony
- **gaming** — serwer gamingowy (kategorie: Informacje, Ogólne, Gaming, Voice, Moderacja)
- **community** — serwer społecznościowy (Witamy, Rozmowy, Twórczość, Voice, Staff)
- **company** — serwer firmowy (Ogólne, Projekty, Development, Design, Spotkania, Zarząd)
- **school** — serwer szkolny (Informacje, Przedmioty, Zadania, Voice, Nauczyciele)
## Przykłady promptów
- *"Zastosuj szablon gaming na serwerze"*
- *"Stwórz kategorię PROJEKTY z kanałami: frontend, backend, devops, code-review"*
- *"Dodaj rolę Moderator z kolorem niebieskim i uprawnieniami do kickowania i banowania"*
- *"Nadaj rolę VIP użytkownikowi o ID 123456789"*
- *"Stwórz regułę AutoMod blokującą spam z mentionami (max 5 mentionów)"*
- *"Wyeksportuj strukturę serwera jako backup"*
- *"Porównaj serwer z szablonem gaming i pokaż co brakuje"*
- *"Pokaż audit log z ostatnimi zmianami kanałów"*
- *"Stwórz wydarzenie 'Game Night' na piątek o 20:00"*
