Veilleur

Name: Veilleur
Author: NoPaperSpray

by NoPaperSprayversion 0.1.0i★ –iRuns on your computer

Registry nameio.github.NoPaperSpray/veilleur

Install

Overview

Description from the maker (original English)

Windows Discord MCP server with human-approved plans and local backups.

PopNx MCP’s three pillars

These three are never merged into one score: opinions, measurements and popularity are different things.

User voiceiNo reviews yetReviews open together with accounts in a later step
Our basic checksi1 of 1 passedChecked from public information; code not scanned yet
UsageiVery new↓ 19/wk · ★ –

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

Connection: Runs on your computer
Transport: stdio
Category: Chat & email
You need to fill in: DISCORD_BOT_TOKEN, DISCORD_GUILD_ID

Install

Pick the AI app you use, then copy the settings.

Before you install

Basic checks: 1 of 1 passed
Runs on your computer with your user’s permissions (files, network, apps).
You fill in yourself: DISCORD_BOT_TOKEN, DISCORD_GUILD_ID, VEILLEUR_HOME

Values marked secret are keys to your account. Never share them or paste them into a chat.

You need

PyPIPython’s uv installed (for the uvx command)

Which app do you use?

ClaudeClaude CodeCursorVS CodeChatGPT

Pick your app above. We remember it, so next time the button says “Install in …”.

Open Claude Desktop → Settings → Developer → Edit Config, and paste this into claude_desktop_config.json

{
  "mcpServers": {
    "veilleur": {
      "command": "uvx",
      "args": [
        "veilleur-discord-mcp"
      ],
      "env": {
        "DISCORD_BOT_TOKEN": "your-value",
        "DISCORD_GUILD_ID": "your-value",
        "VEILLEUR_HOME": "your-value"
      }
    }
  }
}

Run this in your terminal

claude mcp add veilleur --env DISCORD_BOT_TOKEN=your-value --env DISCORD_GUILD_ID=your-value --env VEILLEUR_HOME=your-value -- uvx veilleur-discord-mcp

Fill in the empty values before running it.

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

{
  "mcpServers": {
    "veilleur": {
      "command": "uvx",
      "args": [
        "veilleur-discord-mcp"
      ],
      "env": {
        "DISCORD_BOT_TOKEN": "your-value",
        "DISCORD_GUILD_ID": "your-value",
        "VEILLEUR_HOME": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

{
  "servers": {
    "veilleur": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "veilleur-discord-mcp"
      ],
      "env": {
        "DISCORD_BOT_TOKEN": "your-value",
        "DISCORD_GUILD_ID": "your-value",
        "VEILLEUR_HOME": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

This one runs on your computer, and ChatGPT can only connect to servers on the internet. Pick another app.

Your choice stays on this device in a cookie; no account needed.

Values you fill in

DISCORD_BOT_TOKEN secret required env
Discord bot token; keep it private.
DISCORD_GUILD_ID required env
Numeric ID of the Discord server.
VEILLEUR_HOME env
Optional local folder for backups and plans; defaults to LOCALAPPDATA/Veilleur on Windows.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 10, 2026

✓ Pass
Maker matches the repo
The registry name was verified with the GitHub account NoPaperSpray, which owns the repo
… Not checked yet
Still maintained
We have not read this repo from GitHub yet
… Not checked yet
Has a licence
We have not read this repo from GitHub yet
– Not applicable
Endpoint responds
This one runs on your computer; there is no internet endpoint
– Not applicable
Sign-in with OAuth
Runs on your computer and uses local settings instead
… Not checked yet
No hidden instructions in tool descriptions
Runs on your computer; we can only read tool lists from internet endpoints

Compared with others in Chat & emaili

More stars than 0% of the other 1904 servers in this category
Published to the registry more recently than 68% of the other 1904 servers in this category
Basic checks equal to or better than 100% of the other 1904 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Veilleur safe?

It passed 1 of 1 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

You need to fill in: DISCORD_BOT_TOKEN, DISCORD_GUILD_ID

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed –, and the latest version (0.1.0) reached the registry 13 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Python (uv) on your computer.

What can I use instead?

In the same category: Vexa, emailmd, MCP WhatsApp Cloud

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Vexa

Meeting bot and transcripts for Google Meet, Teams and Zoom. Live or after, speakers labelled.

by Vexa-aiWidely used★ 2.9KUpdated 2 months ago

Runs in the cloud✓ vexa.ai

Install

emailmd

Render markdown into email-safe HTML, lint drafts for deliverability problems, and preview emails.

by anypostWidely used↓ 5.3K/wk★ 1.4KUpdated 34 days ago

Computer or cloud✓ emailmd.dev

Install

MCP WhatsApp Cloud

MCP server for WhatsApp Cloud API (Meta) — messages, media, and templates via Graph API

by codesparEarly↓ 63/wk★ 277Updated 5 months ago

Runs on your computer

Install

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

Veilleur — serveur MCP pour Discord

English version

Veilleur est un serveur MCP (Model Context Protocol) pour gérer un serveur Discord avec une IA. Il tourne en local et passe par un bot Discord pour créer des salons, modifier des rôles, envoyer des embeds, etc.

L'idée : tu dis à l'IA ce que tu veux, elle prépare les changements, et tu valides avant qu'ils soient appliqués. Ça évite de lui laisser les clés du serveur sans savoir ce qu'elle va en faire.

J'ai créé ce projet avec l'aide d'une IA.

Comment ça marche ?

Tu peux par exemple demander :

Crée une catégorie Accueil avec un règlement en lecture seule et un rôle Modérateur.

L'IA te montre les actions prévues. Si ça te va, une fenêtre s'ouvre sur ton PC : tu coches la case et tu valides. Veilleur sauvegarde alors la structure du serveur et l'IA lance les changements.

Tu peux demander un retour arrière si le résultat ne te plaît pas. Attention : ce n'est pas un Ctrl+Z parfait. Un salon supprimé peut être recréé, mais ses messages sont perdus et il aura un nouvel ID. Détails dans Sauvegardes.

Ce qu'il peut faire

Créer, modifier et supprimer des salons, catégories et rôles ; gérer leurs permissions.
Ajouter ou retirer des rôles, chercher des membres, modifier des surnoms et gérer des timeouts.
Envoyer des messages et des embeds, ou modifier les messages envoyés par le bot.
Grouper plusieurs actions, sauvegarder la structure et préparer un retour arrière.

Le bot a besoin des permissions Discord correspondantes et ne peut gérer que les rôles placés sous le sien. Le serveur Discord doit déjà exister.

Installation

1. Prérequis

Windows, Python 3.11 et le lanceur py. L'interface de validation utilise Tkinter, généralement inclus avec Python.
Un serveur Discord sur lequel tu peux inviter un bot.
Un client IA qui prend en charge les serveurs MCP en stdio, comme Codex.
Une connexion Internet : le programme tourne sur ton PC, mais il doit contacter Discord.

2. Créer le bot

Crée une application sur le portail développeur Discord.
Dans l'onglet Bot, génère un token et garde-le pour la suite. Ne le poste nulle part.
Dans OAuth2 → URL Generator, sélectionne bot et les permissions nécessaires, puis ouvre le lien pour inviter le bot.
Dans les paramètres Discord de ton serveur, place son rôle au-dessus des rôles qu'il doit gérer.
Active le mode développeur dans Discord, puis fais un clic droit sur ton serveur → Copier l'identifiant du serveur.

3. Configurer Veilleur

Télécharge ou clone le dépôt, puis ouvre PowerShell dans son dossier :

Set-ExecutionPolicy -Scope Process Bypass

.\installer.ps1

L'installateur crée l'environnement Python ainsi que .env et config.json s'ils n'existent pas encore.

Ouvre .env et mets ton token après le = :

DISCORD_BOT_TOKEN=ton_token

Dans config.json, mets l'ID de ton serveur entre guillemets :

"guild_id": "123456789012345678" }

Ces deux fichiers sont ignorés par Git. Si ton token a fuité, régénère-le sur le portail Discord.

4. Connecter ton client IA

Pour Codex, lance ces commandes dans le dossier du projet :

$pythonDiscord = (Resolve-Path .\.venv\Scripts\python.exe).Path

$serveurDiscord = (Resolve-Path .\server.py).Path codex mcp add discord-local -- $pythonDiscord $serveurDiscord

Redémarre Codex, puis essaie : « Lis mon serveur Discord et propose une organisation. » Si discord-local est déjà configuré avec ces chemins, pas besoin de l'ajouter à nouveau.

Pour OpenCode v2, après avoir installé le projet et renseigné .env et config.json, lance ces commandes dans le dossier du dépôt :

$pythonDiscord = (Resolve-Path .\.venv\Scripts\python.exe).Path

$serveurDiscord = (Resolve-Path .\server.py).Path opencode mcp add veilleur --global -- $pythonDiscord $serveurDiscord opencode mcp list

La configuration est globale : Veilleur sera disponible depuis tes projets OpenCode. Redémarre OpenCode si nécessaire. La connexion a été vérifiée avec OpenCode v2.1.4 et une configuration de test. Pour les autres versions, consulte la documentation OpenCode.

Pour Claude Code, une fois .env et config.json renseignés, lance dans le dossier du dépôt :

$pythonDiscord = (Resolve-Path .\.venv\Scripts\python.exe).Path

$serveurDiscord = (Resolve-Path .\server.py).Path claude mcp add --scope user --transport stdio veilleur -- $pythonDiscord $serveurDiscord claude mcp list

Cette configuration est disponible dans tes projets Claude Code. Elle est distincte de celle du chat Claude Desktop. Connexion vérifiée avec Claude Code 2.1.226 et une configuration de test. Voir la documentation Claude Code.

Pour un autre client MCP compatible stdio, utilise le chemin absolu de .venv\Scripts\python.exe comme commande et celui de server.py comme argument. La config dépend du client. La fenêtre de validation doit pouvoir s'ouvrir dans ta session Windows.

Installation avec pip

Veilleur est disponible sur PyPI et dans le registre MCP officiel. Cherche io.github.NoPaperSpray/veilleur dans le registre.

Sous Windows, tu peux installer le paquet dans un environnement dédié :

py -3.11 -m venv .venv

.\.venv\Scripts\python.exe -m pip install veilleur-discord-mcp

Dans ton client MCP, utilise le chemin absolu de .venv\Scripts\veilleur-discord-mcp.exe comme commande et renseigne les variables d'environnement DISCORD_BOT_TOKEN et DISCORD_GUILD_ID dans sa configuration locale. Garde le token privé : certains clients stockent cette configuration en clair.

Cette installation garde ses plans et sauvegardes dans %LOCALAPPDATA%\Veilleur par défaut. Tu peux choisir un autre dossier avec VEILLEUR_HOME. Dans une copie du dépôt, python -m pip install . installe aussi le paquet. La commande historique python server.py utilise toujours .env, config.json et data/ dans le dossier du dépôt : ses sauvegardes sont séparées de celles du paquet installé.

Validation et sauvegardes

Un plan doit être approuvé dans la fenêtre locale avant de pouvoir être exécuté. L'accord vaut pour ce plan précis, pendant 10 minutes et pour une seule exécution. Si le serveur ou une cible change entre-temps, il faut préparer un nouveau plan.

Avant l'exécution, Veilleur sauvegarde la structure, les rôles, certains paramètres et les membres ou messages directement concernés. Les fichiers sont stockés dans data/ et peuvent contenir des infos privées.

La sauvegarde dépend de ce que le bot peut voir : un salon inaccessible peut manquer. Vérifie ses permissions avant de compter dessus pour une restauration.

La restauration a des limites : les éléments recréés ont de nouveaux IDs ; les messages supprimés, pièces jointes et réactions ne reviennent pas. Les liens externes, fils, invitations et intégrations ne sont pas réparés automatiquement. Les affectations d'un rôle supprimé ne sont pas non plus sauvegardées pour tous les membres.

Un retour arrière passe lui aussi par un aperçu et peut écraser des modifications faites depuis la sauvegarde. En cas d'erreur ou de réponse réseau perdue, consulte le journal avant de relancer quoi que ce soit.

La validation s'applique aux outils MCP de Veilleur. Elle ne protège pas ton token contre un programme qui aurait accès à tes fichiers ou à ton compte Discord.

Dépannage

Le client ne voit pas Veilleur : vérifie les chemins de Python et de server.py, puis redémarre le client.
La fenêtre ne s'ouvre pas : demande l'ID du plan à l'IA, puis lance .\.venv\Scripts\python.exe approve.py ID_DU_PLAN dans le dossier du projet.
Erreur 401 : vérifie le token dans .env.
Erreur 403 : vérifie les permissions et la position du rôle du bot. Certaines recherches de membres et lectures de messages peuvent aussi demander des intents sur le portail Discord.
Le bot est hors ligne : c'est normal. Veilleur utilise l'API HTTP sans connexion Gateway.

Demande aussi à l'IA de lancer diagnostic : il vérifie la connexion et les permissions du bot au niveau du serveur. Il ne calcule pas les exceptions propres à chaque salon.

Pour plus de détails : manuel complet et guide des outils pour l'IA.

Tests

Les tests tournent hors ligne et n'utilisent pas ton token :

.\.venv\Scripts\python.exe -m unittest discover -v

Après une mise à jour du programme, redémarre tes clients MCP pour qu'ils chargent la nouvelle version.

Contribuer

Un bug ou une idée ? Ouvre une issue. Pour proposer du code, regarde CONTRIBUTING.md. Le projet est sous licence MIT.

Veilleur

Overview

PopNx MCP’s three pillars

What you can do with it

Install

Before you install

Values you fill in

What it can do

Basic checksi

Maker matches the repo

Still maintained

Has a licence

Endpoint responds

Sign-in with OAuth

No hidden instructions in tool descriptions

Compared with others in Chat & emaili

Common questions

Alternatives

Vexa

emailmd

MCP WhatsApp Cloud

README from the maker

Veilleur — serveur MCP pour Discord

Comment ça marche ?

Ce qu'il peut faire

Installation

1. Prérequis

2. Créer le bot

3. Configurer Veilleur

4. Connecter ton client IA

Installation avec pip

Validation et sauvegardes

Dépannage

Tests

Contribuer