Forem: fkom13

Comment piloter votre coffre-fort Vaultwarden avec une IA (ou un simple script)

fkom13 — Sat, 15 Nov 2025 08:30:37 +0000

Si vous auto-hébergez vos mots de passe avec Vaultwarden, vous savez que c'est une solution fantastique. Mais avez-vous déjà essayé de l'automatiser ? D'y accéder depuis un script ou, encore plus fou, de demander à une IA de récupérer un mot de passe pour vous ?

C'est compliqué. La CLI officielle de Bitwarden (bw) n'est pas conçue pour une utilisation non-interactive. Il faut gérer des clés de session, des déverrouillages manuels...

Pour résoudre ce problème, nous publions mcp-vaultwarden-server, un petit serveur open-source qui sert de pont sécurisé entre vos scripts (ou votre IA) et votre instance Vaultwarden.

La Solution : Un "Traducteur" pour Vaultwarden

mcp-vaultwarden-server est un serveur léger que vous lancez sur une machine de confiance et qui expose des commandes simples pour interagir avec votre coffre.

En coulisses, il utilise la CLI bw officielle, mais il gère toute la complexité pour vous :

Auto-déverrouillage : Il déverrouille le coffre à la première requête.
Gestion de session : Il garde la session active en cache pour les appels suivants, évitant les déverrouillages répétés.
Interface simple : Il expose des outils clairs comme get_secret, list_secrets, create_secret, etc.

Cas d'usage : Un Agent IA qui utilise vos secrets

Imaginez pouvoir dire à votre assistant IA :

"Utilise l'outil vaultwarden pour récupérer le secret 'API_KEY_AWS' et déploie la nouvelle version de l'application."

Avec mcp-vaultwarden-server, c'est possible. Le serveur est compatible avec le Model-Context-Protocol (MCP), ce qui signifie que des agents comme Gemini ou Claude peuvent l'utiliser comme n'importe quel autre outil.

Comment ça marche ?

Prérequis : Installez la CLI Bitwarden (bw) sur la machine où tournera le serveur.

Installation : Le serveur est un paquet NPM, installable via npx.

# Pas d'installation manuelle requise !
# Il suffit de le configurer dans votre client MCP.

Configuration : Vous fournissez vos identifiants Vaultwarden (URL, client ID/secret, et mot de passe maître) via des variables d'environnement.

// Exemple de configuration pour un client MCP
"vaultwarden": {
  "command": "npx",
  "args": ["mcp-vaultwarden-server"],
  "env": {
    "BITWARDEN_HOST": "https://votre-instance.vaultwarden.com",
    "BW_CLIENTID": "user.xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "BW_CLIENTSECRET": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "BW_MASTER_PASSWORD": "votre-mot-de-passe-maitre"
  }
}

Note de sécurité : La gestion du mot de passe maître est critique. Assurez-vous que le serveur tourne dans un environnement sécurisé et contrôlé.

Prêt à essayer ?

Le projet est open-source et disponible pour tous. C'est la pièce manquante pour intégrer votre gestionnaire de mots de passe auto-hébergé dans vos workflows d'automatisation.

Dépôt GitHub : https://github.com/fkom13/mcp-vaultwarden
Paquet NPM (à venir) : Nous allons le publier prochainement.

Vos retours et contributions sont les bienvenus !

GenCodeDoc : Le Time Machine pour votre code, sans la lourdeur de Git

fkom13 — Sat, 15 Nov 2025 08:26:15 +0000

Vous avez déjà rêvé de pouvoir sauvegarder l'état de votre projet à un instant T, sans pour autant créer un commit Git juste pour "un test" ? Ou de générer une documentation complète de votre code en une seule commande ?

C'est précisément pour cela que nous avons créé GenCodeDoc, un outil de versioning intelligent et de documentation automatique, open-source et maintenant disponible sur PyPI (pip install gencodedoc).

Le Problème : Le "Micro-Versioning" et la Documentation Manuelle

Git est parfait pour le versioning majeur, mais il est souvent trop lourd pour le suivi de l'exploration et du développement au quotidien. On se retrouve souvent à faire des commit -m "WIP" ou à dupliquer des dossiers (project_v2, project_v2_final), ce qui est inefficace. De plus, maintenir une documentation à jour est une tâche que l'on repousse constamment.

La Solution : Snapshots Intelligents et Docs Automatisées

GenCodeDoc aborde ces deux problèmes avec une approche moderne :

1. Des "Snapshots" plutôt que des Commits

Avec GenCodeDoc, vous prenez des "photographies" (snapshots) de votre projet quand vous le voulez.

# Après avoir installé l'outil (pip install gencodedoc)
# et l'avoir initialisé dans votre projet (gencodedoc init)

# Prenez un snapshot avant un refactoring majeur
gencodedoc snapshot create --message "Avant refactoring de l'API" --tag pre-refactor

# ... vous cassez tout ...

# Pas de panique, revenez en arrière en une seconde
gencodedoc snapshot restore pre-refactor

La magie opère en coulisses :

Déduplication : Seuls les fichiers modifiés sont réellement stockés. Un fichier identique sur 100 snapshots n'est sauvegardé qu'une seule fois. Résultat : ~70% d'économie d'espace.
Compression : Tout est compressé avec zstd pour une efficacité maximale.
Autosave : Activez un gardien qui sauvegarde votre travail automatiquement en fonction du temps ou du pourcentage de changements.

2. Une Documentation qui s'écrit toute seule

Oubliez la corvée de la documentation.

gencodedoc doc generate --output DOCS.md

Cette commande analyse votre projet et génère un fichier Markdown complet incluant :

L'arborescence complète du projet.
Le contenu de chaque fichier, avec coloration syntaxique.
Des statistiques sur le projet (nombre de lignes, de fichiers, etc.).

Triple Interface : CLI, API REST, et MCP pour l'IA

GenCodeDoc est conçu pour la flexibilité :

CLI : Une interface en ligne de commande complète pour un usage manuel.
API REST : Intégrez GenCodeDoc dans vos propres applications.
MCP (Model-Context-Protocol) : La fonctionnalité la plus unique. Exposez les 17 outils de GenCodeDoc à un agent IA (comme Gemini ou Claude) pour piloter le versioning et la documentation en langage naturel.

"Hey Gemini, crée un snapshot de mon projet avec le tag 'v2.1-beta' et génère la doc."

Pour commencer

Le projet est open-source et disponible sur PyPI.

Installation :
```
pip install gencodedoc
```
Initialisation dans votre projet :
```
gencodedoc init --preset python
```
Explorez !
```
gencodedoc --help
```

Nous pensons que GenCodeDoc peut changer la manière dont les développeurs et les IA collaborent sur le code au quotidien.

Dépôt GitHub : https://github.com/fkom13/gencodedoc
Documentation Complète : Lien vers DOCUMENTATION.md sur le dépôt

N'hésitez pas à l'essayer et à nous faire vos retours sur GitHub !

Show HN: MCP Orchestrator – Pilotez vos serveurs SSH/SFTP avec n'importe quelle IA

fkom13 — Sat, 15 Nov 2025 08:18:28 +0000

Le problème : La gestion de serveurs est un chaos (organisé ?)

Si vous êtes développeur, DevOps ou administrateur système, votre quotidien ressemble probablement à une jonglerie entre plusieurs terminaux, des scripts SSH qui vieillissent mal, et des commandes scp à rallonge.

Gérer des serveurs, déployer des applications, transférer des fichiers, et monitorer des services est une tâche complexe et répétitive. On finit souvent avec :

Des scripts shell spécifiques à chaque machine.
Des commandes ssh et sftp tapées à la main, sources d'erreurs.
Un manque de visibilité sur les tâches longues.
Une difficulté à automatiser de manière fiable et centralisée.

Et si on pouvait piloter tout ça depuis une interface unifiée, voire... directement depuis une conversation avec une IA ?

La solution : `mcp-orchestrator-server`

C'est exactement le problème que nous avons voulu résoudre en créant mcp-orchestrator-server, un serveur d'orchestration open-source basé sur Node.js et le Model-Context-Protocol (MCP).

En bref : C'est un outil que vous lancez en arrière-plan et qui expose une API riche pour gérer vos serveurs. Il est conçu pour être piloté par un client MCP, comme une interface en ligne de commande (CLI) ou, plus intéressant encore, un agent IA comme Gemini.

GitHub : https://github.com/fkom13/mcp-sftp-orchestrator
NPM : https://www.npmjs.com/package/mcp-orchestrator-server

Qu'est-ce que ça fait concrètement ?

Imaginez pouvoir taper des commandes en langage naturel et voir la magie opérer. Voici quelques exemples.

1. Exécuter une séquence de déploiement

Fini les scripts bash fragiles. Déployez votre application avec une seule commande sémantique.

L'intention :

"Sur le serveur 'prod_vps', déploie la dernière version de mon app : va dans le dossier /var/www/app, fais un git pull, installe les dépendances npm, et redémarre le service pm2."

La commande MCP correspondante :

{
  "tool": "task_exec_sequence",
  "arguments": {
    "alias": "prod_vps",
    "commands": [
      "cd /var/www/app",
      "git pull origin main",
      "npm install",
      "pm2 restart app"
    ]
  }
}

2. Transférer des fichiers avec des patterns complexes

Besoin de sauvegarder tous les logs et les fichiers de configuration ?

L'intention :

"Sauvegarde tous les logs de l'application et les fichiers de configuration JSON du serveur 'prod_vps' dans mon dossier local de backups."

La commande MCP :

{
  "tool": "task_transfer_multi",
  "arguments": {
    "alias": "prod_vps",
    "direction": "download",
    "files": [
      {
        "remote": "/var/log/app/*.log",
        "local": "/home/user/backups/logs/"
      },
      {
        "remote": "/etc/app/configs/**/*.json",
        "local": "/home/user/backups/configs/"
      }
    ]
  }
}

3. Monitorer un service en temps réel

Un bug en production ? Affichez les logs en direct.

L'intention :

"Montre-moi les 100 dernières lignes de logs d'erreurs de l'app 'api-server' sur 'prod_vps'."

La commande MCP :

{
  "tool": "get_pm2_logs",
  "arguments": {
    "alias": "prod_vps",
    "app": "api-server",
    "lines": 100,
    "errors": true
  }
}

Fonctionnalités Clés

Gestion de Serveurs Centralisée : Ajoutez tous vos serveurs via l'outil server_add et appelez-les par un simple alias.
Pool de Connexions SSH : Les connexions sont maintenues et réutilisées pour des performances optimales.
Queue de Tâches Persistante : Les tâches longues (transferts, commandes...) continuent en arrière-plan et survivent à un redémarrage du serveur.
Exécution Hybride : Les tâches rapides retournent un résultat immédiatement, les tâches longues sont asynchrones.
Monitoring Intégré : Outils pour vérifier les ressources système, le statut des services (systemd, Docker, PM2), et la santé de vos APIs.

Installation et Utilisation

Le moyen le plus simple est d'utiliser npx. Configurez votre client MCP (comme gemini-cli) pour qu'il utilise l'orchestrateur :

{
  "mcpServers": {
    "orchestrator": {
      "command": "npx",
      "args": [
        "mcp-orchestrator-server"
      ],
      "env": {
        "MCP_DATA_DIR": "~/.config/mcp-orchestrator"
      }
    }
  }
}

C'est tout ! Votre client peut maintenant communiquer avec le serveur et utiliser tous ses outils.

Conclusion

mcp-orchestrator-server est un pas vers une gestion d'infrastructure plus intelligente et automatisée. En l'exposant via le Model-Context-Protocol, il devient un outil surpuissant dans l'arsenal de tout développeur ou DevOps qui utilise des agents IA.

Nous vous invitons à l'essayer, à contribuer sur GitHub et à nous faire part de vos retours !

Forem: fkom13

Comment piloter votre coffre-fort Vaultwarden avec une IA (ou un simple script)

La Solution : Un "Traducteur" pour Vaultwarden

Cas d'usage : Un Agent IA qui utilise vos secrets

Comment ça marche ?

Prêt à essayer ?

GenCodeDoc : Le Time Machine pour votre code, sans la lourdeur de Git

Le Problème : Le "Micro-Versioning" et la Documentation Manuelle

La Solution : Snapshots Intelligents et Docs Automatisées

1. Des "Snapshots" plutôt que des Commits

2. Une Documentation qui s'écrit toute seule

Triple Interface : CLI, API REST, et MCP pour l'IA

Pour commencer

Show HN: MCP Orchestrator – Pilotez vos serveurs SSH/SFTP avec n'importe quelle IA

Le problème : La gestion de serveurs est un chaos (organisé ?)

La solution : mcp-orchestrator-server

Qu'est-ce que ça fait concrètement ?

1. Exécuter une séquence de déploiement

2. Transférer des fichiers avec des patterns complexes

3. Monitorer un service en temps réel

Fonctionnalités Clés

Installation et Utilisation

Conclusion

La solution : `mcp-orchestrator-server`