HackMD : serveur MCP, installation et sécurité

À quoi sert HackMD

D'après son dépôt : « Interagir avec HackMD. »

Un serveur MCP donne à un agent IA des outils supplémentaires, appelés au fil de la conversation : l'agent lit leur description, décide de les utiliser et reçoit le résultat. HackMD est classé dans la catégorie Autres intégrations, qui réunit 194 serveurs dans l'annuaire ; il y occupe la 103^e place par nombre d'étoiles.

Mots-clés déclarés par le dépôt : hackmd, api.

Installer et brancher HackMD

Modes de distribution déclarés dans le registre MCP officiel :

• paquet npm (Node.js, lancé en général avec npx)
• image Docker (OCI)
• paquet MCPB (installation en un clic dans Claude Desktop)
• serveur distant (streamable-http) : on s'y connecte par une adresse URL, sans rien installer sur sa machine

Comme tout serveur MCP, il se déclare dans la configuration de votre client (Claude Desktop, Claude Code, Cursor, VS Code, Codex…) : un nom, la commande qui le lance ou son adresse, et les variables d'environnement éventuelles. Le client le démarre ensuite et liste ses outils. Langage du projet : TypeScript.

Le registre indique 3 variables secrètes à fournir (clé d'API, jeton d'accès). Gardez-les dans les variables d'environnement du client, jamais dans un fichier partagé ou un dépôt.

Sécurité : ce qu'il faut vérifier

Un serveur MCP exécute du code avec les droits que vous lui donnez, et ses descriptions d'outils sont lues par le modèle : un serveur malveillant ou compromis peut détourner l'agent. Lisez le code ou choisissez un serveur maintenu et suivi avant de le brancher.

Points relevés pour HackMD :

• Secrets : le serveur agit avec vos identifiants. Créez une clé dédiée, avec les droits minimum et une date d'expiration.

Bonnes pratiques : n'accorder que les droits nécessaires (moindre privilège), exiger une validation humaine pour les actions irréversibles, et faire le point avec le diagnostic de sécurité d'agent IA.

Activité et maintenance du projet

Créé le 18 mars 2025, le dépôt yuna0x0/hackmd-mcp totalise 67 étoiles et 16 copies (forks), avec 0 tickets ouverts. Il compte plus d'étoiles que 58 % des serveurs de l'annuaire. Dernière modification il y a 3 mois. Version publiée dans le registre : 1.5.7 (28 novembre 2025).

Les étoiles mesurent l'attention reçue, pas la qualité : un projet récent et très médiatisé peut en accumuler vite, un serveur utile mais spécialisé en aura peu.