Veilleur

Name: Veilleur
Author: NoPaperSpray

作者：NoPaperSpray版本 0.1.0i★ 0i在你的电脑上运行

注册名称io.github.NoPaperSpray/veilleur

安装

概览

作者提供的说明（英文原文）

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

PopNx MCP 的三大支柱

这三项永远不会合并成一个分数：意见、测量和人气是不同的东西。

用户评价i暂无评价评价功能将在后续阶段与账户功能一起开放
我们的基础检查i2 项中通过 2 项依据公开信息检查；尚未扫描代码
使用情况i非常新↓ 19/周 · ★ 0

它能帮你做什么

我们还没有为它写通俗的介绍。下面是我们从注册中心读取到的事实。

连接方式: 在你的电脑上运行
传输方式: stdio
分类: 聊天与邮件
你需要填写：DISCORD_BOT_TOKEN, DISCORD_GUILD_ID

安装

选择你使用的 AI 应用，然后复制设置。

安装之前

基础检查：2 项中通过 2 项
在你的电脑上运行，拥有你的用户账户的权限（文件、网络、应用）。
需要你自己填写： DISCORD_BOT_TOKEN, DISCORD_GUILD_ID, VEILLEUR_HOME

标为机密的值是你账户的钥匙。千万不要分享给别人，也不要粘贴到聊天里。

你需要

PyPI已安装 Python 的 uv（用于 uvx 命令）

你用的是哪个应用？

ClaudeClaude CodeCursorVS CodeChatGPT

在上方选择你的应用。我们会记住它，下次按钮会显示“安装到 …”。

打开 Claude Desktop → Settings → Developer → Edit Config，把下面的内容粘贴到 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"
      }
    }
  }
}

在终端中运行这条命令

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

运行前请先填写空着的值。

在 Cursor 中打开

或者自己复制设置

粘贴到项目中的 .cursor/mcp.json，或 ~/.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"
      }
    }
  }
}

浏览器会先询问是否打开应用，然后应用会显示设置并请你确认。密钥的值会留空，由你自己填写。

在 VS Code 中打开

或者自己复制设置

粘贴到项目中的 .vscode/mcp.json

{
  "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"
      }
    }
  }
}

浏览器会先询问是否打开应用，然后应用会显示设置并请你确认。密钥的值会留空，由你自己填写。

这个服务器在你的电脑上运行，而 ChatGPT 只能连接互联网上的服务器。请选择其他应用。

你的选择通过 Cookie 保存在这台设备上，无需账户。

需要你填写的值

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

这些设置是根据作者在注册中心的条目生成的。如果 README 的写法不同，请以 README 为准。

哪些应用可以使用它

依据这个服务器的连接方式和各应用自己的文档，检查于 2026年11月10日。

在你的电脑上运行，适用于

Claude Goose LM Studio Msty Studio Cherry Studio Cursor VS Code + GitHub Copilot Visual Studio Windsurf (Devin Desktop)Zed Kiro Cline Continue JetBrains AI Assistant Claude Code Codex CLI Gemini CLI OpenCode nodecode Warp LibreChat Raycast

全部应用及其优缺点 →

它能做什么

它在你的电脑上运行；安装后，工具列表会显示在你的 AI 应用中。

基础检查i

我们检查的是任何人都能看到的信息；我们没有阅读代码。不适用的检查项不计入总数。 · 检查于 2026年11月10日

✓ 通过
作者与仓库一致
注册名称已通过 GitHub 账户 NoPaperSpray 验证，该账户拥有此仓库
✓ 通过
仍在维护
代码最后更新于14天前
… 尚未检查
有许可证
我们还没有从 GitHub 读取这个仓库
– 不适用
端点有响应
它在你的电脑上运行，没有互联网端点
– 不适用
使用 OAuth 登录
在你的电脑上运行，改用本地设置
… 尚未检查
工具描述中没有隐藏指令
它在你的电脑上运行；我们只能读取互联网端点的工具列表

与“聊天与邮件”中的其他服务器比较i

星标数多于此分类中其他 1919 个服务器的 0%
发布到注册中心的时间比此分类中其他 1919 个服务器的 67% 更新
基础检查结果等于或优于此分类中其他 1919 个服务器的 100%

与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时，星标数才计入。

常见问题

Veilleur 安全吗？

它在 2 项适用的基础检查中通过了 2 项。我们没有阅读代码。在添加密钥或令牌之前，请先看看这个服务器要求哪些权限，并使用只具备所需权限的密钥。

它需要哪些密钥或代码？

你需要填写：DISCORD_BOT_TOKEN, DISCORD_GUILD_ID

它在我的电脑上运行还是在云端？

它在你的电脑上运行。你的 AI 应用会在需要时启动它，数据不会经过作者的服务器（除非它自己调用在线服务）。

它还在维护吗？

GitHub 仓库最后更新于14天前，最新版本（0.1.0）于14天前进入注册中心。

哪些应用可以使用它？

支持 MCP 的应用，例如 Claude Desktop、Claude Code、Cursor 和 VS Code。你的电脑上还需要有 Python (uv)。

有什么可以替代它？

同一分类中有：Inbox Zero, Agent-Native Mail, Agent-Native Dispatch

替代选择

同一分类中其他作者的服务器，按星标数排序。

如何看卡片：↓ 每周下载量i★ GitHub 星标i三大支柱：评价 · 检查 · 使用情况i更新 = 最新版本发布到注册中心的时间i

Inbox Zero

Search Gmail and Outlook, save drafts, manage email rules, and view email stats.

作者：elie222广泛使用★ 1.3万40天前更新

在云端运行

安装

Agent-Native Mail

Agent-Native Superhuman - email client with keyboard shortcuts and AI triage

作者：BuilderIO广泛使用★ 76652个月前更新

在云端运行

安装

Agent-Native Dispatch

Central Slack/Telegram router with jobs, memory, approvals, and A2A delegation

作者：BuilderIO广泛使用★ 76652个月前更新

在云端运行

安装

作者的 README

打开 README

按原文从作者的仓库复制。PopNx MCP 没有审查或背书其内容。HTML、图片和脚本已被移除。链接会离开本站。

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

概览

PopNx MCP 的三大支柱

它能帮你做什么

安装

安装之前

需要你填写的值

哪些应用可以使用它

它能做什么

基础检查i

作者与仓库一致

仍在维护

有许可证

端点有响应

使用 OAuth 登录

工具描述中没有隐藏指令

与“聊天与邮件”中的其他服务器比较i

常见问题

替代选择

Inbox Zero

Agent-Native Mail

Agent-Native Dispatch

作者的 README

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