프로토타입 · 미리 보기: 공식 레지스트리의 모든 서버를 담고 있으며 30분마다 동기화해요. 리뷰와 계정 기능은 다음 단계에서 열려요.
PopNx MCPAI를 쓰는 사람을 위한 MCP 서버 · 쉬운 말로 설명해요

Veilleur

제작자: NoPaperSpray버전 0.1.0i★ –i내 컴퓨터에서 실행
레지스트리 이름io.github.NoPaperSpray/veilleur

설치

개요

제작자가 쓴 설명(영어 원문)

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

PopNx MCP의 세 기둥

이 세 가지는 절대 하나의 점수로 합치지 않아요. 의견, 측정, 인기는 서로 다른 것이니까요.

할 수 있는 일

이 서버는 아직 쉬운 말로 된 요약을 쓰지 못했어요. 아래는 레지스트리에서 읽어 온 사실이에요.

  • 연결 방식: 내 컴퓨터에서 실행
  • 전송 방식: stdio
  • 카테고리: 채팅 및 이메일
  • 입력해야 할 값: DISCORD_BOT_TOKEN, DISCORD_GUILD_ID

설치

쓰고 있는 AI 앱을 고른 다음 설정을 복사하세요.

설치하기 전에

  • 기본 점검: 1개 중 1개 통과
  • 내 컴퓨터에서 내 사용자 계정의 권한(파일, 네트워크, 앱)으로 실행돼요.
  • 직접 입력할 값: DISCORD_BOT_TOKEN, DISCORD_GUILD_ID, VEILLEUR_HOME

비밀로 표시된 값은 내 계정의 열쇠예요. 절대 다른 사람과 공유하거나 채팅에 붙여 넣지 마세요.

필요한 것

  • PyPIPython의 uv 설치(uvx 명령어용)

어떤 앱을 쓰세요?

위에서 앱을 고르세요. 기억해 두었다가 다음부터는 버튼에 “…에 설치”라고 표시해요.

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는 인터넷에 있는 서버에만 연결할 수 있어요. 다른 앱을 고르세요.

선택한 앱은 이 기기의 쿠키에만 저장돼요. 계정은 필요 없어요.

직접 입력할 값

  • 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를 따르세요.

할 수 있는 일

내 컴퓨터에서 실행돼요. 설치하면 AI 앱에 도구 목록이 나타나요.

기본 점검i

누구나 볼 수 있는 정보를 점검했고, 코드는 읽지 않았어요. 해당하지 않는 항목은 개수에서 뺐어요. · 2026년 11월 8일 점검

  • ✓ 통과

    제작자와 저장소 일치

    레지스트리 이름이 GitHub 계정 NoPaperSpray 기준으로 확인되었고, 이 계정이 저장소를 소유하고 있어요

  • … 아직 점검 안 함

    계속 관리되고 있음

    아직 GitHub에서 이 저장소를 읽어 오지 않았어요

  • … 아직 점검 안 함

    라이선스 있음

    아직 GitHub에서 이 저장소를 읽어 오지 않았어요

  • – 해당 없음

    엔드포인트 응답

    내 컴퓨터에서 실행되는 서버라 인터넷 엔드포인트가 없어요

  • – 해당 없음

    OAuth로 로그인

    내 컴퓨터에서 실행되며, 대신 로컬 설정을 사용해요

  • … 아직 점검 안 함

    도구 설명에 숨겨진 지시 없음

    내 컴퓨터에서 실행돼요. 도구 목록은 인터넷 엔드포인트가 있는 서버에서만 읽을 수 있어요

채팅 및 이메일 카테고리의 다른 서버와 비교i

  • 이 카테고리의 다른 서버 1848개 중 0%보다 스타가 많아요
  • 이 카테고리의 다른 서버 1848개 중 71%보다 최근에 레지스트리에 공개됐어요
  • 기본 점검 결과가 이 카테고리의 다른 서버 1848개 중 100%와 같거나 더 좋아요

레지스트리에서 이 카테고리의 활성 서버 전체와 비교했어요. 스타는 게시자가 저장소를 소유한 경우에만 세요.

자주 묻는 질문

Veilleur, 안전한가요?

해당하는 기본 점검 1개 중 1개를 통과했어요. 코드는 읽지 않았어요. 키나 토큰을 넣기 전에 서버가 어떤 권한을 요구하는지 확인하고, 꼭 필요한 권한만 있는 키를 쓰세요.

어떤 키나 코드가 필요한가요?

입력해야 할 값: DISCORD_BOT_TOKEN, DISCORD_GUILD_ID

내 컴퓨터에서 실행되나요, 클라우드에서 실행되나요?

내 컴퓨터에서 실행돼요. AI 앱이 필요할 때 실행하고, 데이터는 제작자의 서버를 거치지 않아요(서버 자체가 온라인 서비스를 호출하는 경우는 제외).

아직 관리되고 있나요?

GitHub 저장소는 마지막으로 – 변경됐고, 최신 버전(0.1.0)은 11일 전 레지스트리에 올라왔어요.

어떤 앱에서 쓸 수 있나요?

Claude Desktop, Claude Code, Cursor, VS Code처럼 MCP를 지원하는 앱에서 쓸 수 있어요. 내 컴퓨터에 Python (uv)도 있어야 해요.

대신 쓸 수 있는 건 뭐가 있나요?

같은 카테고리에는: Vexa, emailmd, MCP WhatsApp Cloud

대안

같은 카테고리에서 다른 제작자가 만든 서버예요. 스타 순으로 정렬했어요.

카드 보는 법:↓ 주간 다운로드i★ GitHub 스타i세 기둥: 리뷰 · 점검 · 사용 정도i업데이트 = 최신 버전을 레지스트리에 공개한 날i

Vexa

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

제작자: Vexa-ai널리 사용됨★ 2.9천2개월 전 업데이트

클라우드에서 실행✓ vexa.ai

emailmd

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

제작자: anypost성장 중↓ 5.3천/주★ 1.4천32일 전 업데이트

컴퓨터 또는 클라우드✓ emailmd.dev

MCP WhatsApp Cloud

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

제작자: codespar초기↓ 63/주★ 2775개월 전 업데이트

내 컴퓨터에서 실행

제작자의 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
  1. Crée une application sur le portail développeur Discord.
  2. Dans l'onglet Bot, génère un token et garde-le pour la suite. Ne le poste nulle part.
  3. Dans OAuth2 → URL Generator, sélectionne bot et les permissions nécessaires, puis ouvre le lien pour inviter le bot.
  4. Dans les paramètres Discord de ton serveur, place son rôle au-dessus des rôles qu'il doit gérer.
  5. 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.

PopNx에게 묻기