Skills MCP Server

Un serveur Model Context Protocol (MCP) permettant d'exposer une bibliothèque de "skills" (compétences) sous forme de fichiers Markdown. Ces skills peuvent être utilisées comme prompts pour configurer des sous-agents ou guider des interactions IA.

🌟 Fonctionnalités

• GetSkills : Liste toutes les compétences disponibles.
• GetSkillPrompt : Récupère le contenu Markdown d'une compétence spécifique.
• Configuration Flexible : Définissez votre propre dossier de skills via une variable d'environnement ou un fichier .env.
• Exécution npx : Prêt à être exécuté sans installation globale.
• Sécurité Intégrée : Validation par Zod et protection contre le Path Traversal.

📁 Structure

• src/index.ts : Serveur principal MCP.
• src/skills/ : Dossier par défaut des compétences (fichiers .md).
• dist/ : Version compilée (nécessaire pour npx).

🛠️ Configuration

Vous pouvez spécifier le chemin vers votre dossier de skills en utilisant la variable d'environnement SKILLS_PATH.

1. Créez un fichier .env à la racine (facultatif) :

   SKILLS_PATH=C:/Chemin/Vers/Mes/Skills

2. Ou définissez-la directement dans votre environnement.

🚀 Utilisation

Via npx (Recommandé)

Vous pouvez lancer le serveur directement sans installation :

npx custom-skills-mcp

Installation Manuelle

npm install
npm run build
npm start

Configuration dans Cursor ou Claude Desktop

Ajoutez le serveur MCP dans votre configuration :

{
  "mcpServers": {
    "skills": {
      "command": "npx",
      "args": ["-y", "custom-skills-mcp"],
      "env": {
        "SKILLS_PATH": "C:/Chemin/Vers/Vos/Skills"
      }
    }
  }
}

Note : Utilisez -y avec npx pour éviter les demandes de confirmation lors de la première utilisation.

🔄 Configuration Proxy (Optionnel)

Le serveur GUI peut s'enregistrer automatiquement auprès d'un reverse proxy dynamique pour être accessible via un chemin unique.

Variables d'environnement

| Variable | Description | Défaut | |----------|-------------|--------| | PROXY_URL | URL du proxy (ex: http://localhost:3000) | Non défini | | PROXY_APP_PATH | Chemin d'accès via le proxy | /skills-gui | | PROXY_APP_NAME | Nom affiché dans le proxy | Skills MCP GUI |

Exemple de configuration

{
  "mcpServers": {
    "skills": {
      "command": "npx",
      "args": ["-y", "custom-skills-mcp"],
      "env": {
        "SKILLS_PATH": "C:/Chemin/Vers/Vos/Skills",
        "PROXY_URL": "http://localhost:3000",
        "PROXY_APP_PATH": "/skills-gui",
        "PROXY_APP_NAME": "Skills MCP GUI"
      }
    }
  }
}

Comportement

• Sans PROXY_URL : Le serveur GUI démarre sur le port défini par GUI_PORT (défaut: 3000)
• Avec PROXY_URL : Le serveur s'enregistre auprès du proxy et reçoit un port dynamique
• Proxy indisponible : Fallback automatique sur le port par défaut après 2 secondes

📝 Logs et Débogage

Les logs du serveur MCP et de l'interface GUI sont centralisés dans un fichier unique :

• Windows : C:\var\log\skills-mcp\server.log
• Linux/Mac : /var/log/skills-mcp/server.log

Chaque entrée est préfixée par [MASTER] ou [GUI] pour faciliter le diagnostic.

L'interface web sera alors accessible via : http://localhost:3000/skills-gui/

📝 Ajouter une nouvelle Skill

1. Créez un fichier .md dans votre dossier de skills (ex: expert-python.md).
2. Rédigez votre prompt.
3. Le serveur détectera automatiquement le nouveau fichier lors du prochain appel à GetSkills.

🛡️ Bonnes Pratiques

Ce serveur respecte les principes de sécurité MCP :

• Lecture seule par défaut.
• Validation stricte des arguments.
• Logs de debug sur stderr.