Corporate Tools Server (MCP)

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 :

⚠️ 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.

Related MCP server: Mailbuttons MCP Server

🛠️ 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.