Ce dépôt contient un serveur de micro-outils d'entreprise basé sur le protocole MCP (Model Context Protocol) utilisant le framework FastMCP. Il expose des outils permettant à un agent d'intelligence artificielle de consulter les politiques RH, de créer des tickets de support informatique et d'envoyer des e-mails externes de manière sécurisée.

Le serveur intègre une politique de sécurité stricte (TOOLS_SECURITY) pour classifier les risques liés à l'exécution de chaque outil (notamment la validation humaine requise pour les actions critiques).

---

📋 Fonctionnalités et Matrice de Sécurité

Les outils sont configurés selon le niveau de risque suivant :

Outil	Description	Type	Risque	Confirmation Requise
search_policy	Consulter les procédures internes RH	READ	LOW	❌ Non
create_ticket	Créer un ticket support informatique	WRITE	MEDIUM	❌ Non
send_email	Envoyer un e-mail externe	SEND	HIGH	Oui (Human-in-the-loop)

⚠️ Sécurité : Les métadonnées de sécurité sont injectées directement dans les descriptions des outils (docstrings) afin que l'agent IA ou le client MCP puisse intercepter et valider l'action avant son exécution.

---

🛠️ Prérequis

Avant de commencer, assurez-vous d'avoir installé :

• Python 3.10 ou supérieur
• pip (gestionnaire de paquets Python)

---

Installation

Python Version

Recommended:

Python >= 3.10

Check your version:

python --version

---

⚙️ Create Virtual Environment

Windows

Create the environment:

python -m venv venv

Activate:

venv\\Scripts\\activate

You should see:

(venv)

---

Linux / macOS

Create:

python3 -m venv venv

Activate:

source venv/bin/activate

---

📦 Install Dependencies

Upgrade pip:

python -m pip install --upgrade pip

Install packages:

pip install -r requirements.txt

---

🔑 Configure Groq API Key

Create a file:

.env

at the project root.

Add:

GROQ_API_KEY=your_groq_api_key_here

Example:

GROQ_API_KEY=gsk_xxxxxxxxxxxxx

Never commit this file to GitHub.

---

🖥️ Intégration avec Claude Desktop (Bonus)

Ce serveur MCP utilise le transport STDIO (Standard Input/Output), ce qui le rend compatible avec Claude Desktop.

Étape 1 : Localiser le fichier de configuration

Modifiez le fichier claude_desktop_config.json situé à l'un des emplacements suivants :

• Windows

%APPDATA%\Claude\claude_desktop_config.json

• macOS

~/Library/Application Support/Claude/claude_desktop_config.json

---

Étape 2 : Ajouter le serveur MCP

Ajoutez la configuration suivante dans le fichier :

{
  "mcpServers": {
    "corporate-tools": {
      "command": "python",
      "args": [
        "/chemin/absolu/vers/votre/projet/server.py"
      ],
      "env": {}
    }
  }
}

Remarque : Remplacez /chemin/absolu/vers/votre/projet/server.py par le chemin absolu de votre fichier server.py.

---

Exemple sous Windows

{
  "mcpServers": {
    "corporate-tools": {
      "command": "python",
      "args": [
        "/chemin/absolu/vers/votre/projet/server.py"
      ],
      "env": {}
    }
  }
}

---

Exemple sous macOS

{
  "mcpServers": {
    "corporate-tools": {
      "command": "python3",
      "args": [
        "/chemin/absolu/vers/votre/projet/server.py"
      ],
      "env": {}
    }
  }
}

---

Étape 3 : Redémarrer Claude Desktop

Après avoir enregistré le fichier de configuration :

1. Fermez complètement Claude Desktop.
2. Relancez l'application.
3. Le serveur Corporate Tools sera automatiquement démarré par Claude.

---

Vérification

Si la configuration est correcte, Claude Desktop détectera automatiquement le serveur MCP et les outils.

Vous pouvez alors interagir avec ces outils directement depuis Claude Desktop.