What is Mcp Exemple

mcp-exemple is a project that transforms AI assistants like Claude into interactive agents through a user management API, enabling them to perform various tasks without the need for a specific interface.

Use cases

Use cases include automating user account management, integrating AI into existing systems for enhanced user interaction, and simplifying administrative tasks through natural language commands.

How to use

To use mcp-exemple, install the required dependencies, build the API and MCP server, and then run them in development mode. You can interact with the AI assistant by sending commands related to user management.

Key features

Key features include a REST API for user management (CRUD operations), integration with Claude for executing commands, and the ability to perform tasks like creating, updating, and deleting users through simple text commands.

Where to use

mcp-exemple can be used in fields such as software development, IT management, and any domain that requires efficient user management through AI interaction.

Model Context Protocol (MCP) - Démonstration avec une API Utilisateurs

🚀 La révolution du MCP

Le Model Context Protocol (MCP) transforme les assistants IA comme Claude de simples générateurs de texte en véritables agents capables d’interagir avec vos systèmes informatiques.

Ce projet démontre concrètement cette révolution à travers une simple API de gestion d’utilisateurs, connectée à Claude via un serveur MCP.

💡 Pourquoi c’est révolutionnaire ?

Demandez simplement à Claude :

• “Crée un utilisateur nommé Jean Dupont, 42 ans, rôle administrateur”
• “Liste tous les utilisateurs dont l’âge est supérieur à 30 ans”
• “Mets à jour le rôle de l’utilisateur #3 en ‘manager’”
• “Supprime l’utilisateur #5”

Et Claude exécutera ces actions instantanément, sans interface spécifique à développer !

🔧 Technologies utilisées

• Backend : TypeScript, Node.js, Express
• Base de données : TypeORM, SQLite
• MCP : Model Context Protocol SDK
• Intégration : Claude pour Desktop

🛠️ Architecture du projet

Le projet se compose de deux parties principales :

1. API REST utilisateurs : Gestion CRUD classique des utilisateurs
2. Serveur MCP : Pont entre Claude et l’API

┌─────────────────┐     ┌─────────────────┐     ┌─────────────┐
│                 │     │                 │     │             │
│  Claude/IA      │────▶│  Serveur MCP    │────▶│  API REST   │
│  Assistant      │◀────│                 │◀────│             │
│                 │     │                 │     │             │
└─────────────────┘     └─────────────────┘     └─────────────┘

🚀 Installation et démarrage

Prérequis

• Node.js (v16+)
• npm (v7+)

Installation

# Installer les dépendances
npm install

# Construire l'API
npm run build

# Construire le serveur MCP
npm run build:mcp

Utilisation locale

# Démarrer l'API en développement
npm run dev

# Dans un autre terminal, démarrer le serveur MCP
npm run start:mcp

# Ou utiliser le script pour démarrer les deux serveurs en même temps
./start-servers.sh

🔌 Configuration de Claude Desktop

Modifiez le fichier de configuration de Claude (~/Library/Application Support/Claude/claude_desktop_config.json) :

{
  "mcpServers": {
    "user-api": {
      "command": "node",
      "args": [
        "/CHEMIN/ABSOLU/VERS/PROJET/mcp-server/dist/mcp/index.js"
      ],
      "env": {
        "API_URL": "http://localhost:4000/api"
      }
    }
  }
}

Remplacez /CHEMIN/ABSOLU/VERS/PROJET par le chemin absolu vers le dossier du projet sur votre machine.

📚 API REST - Points d’accès

• GET /api/users - Obtenir tous les utilisateurs
• GET /api/users/:id - Obtenir un utilisateur par ID
• POST /api/users - Créer un nouvel utilisateur
• PUT /api/users/:id - Mettre à jour un utilisateur
• DELETE /api/users/:id - Supprimer un utilisateur

🧰 Outils MCP disponibles

• list-users - Lister tous les utilisateurs
• get-user - Obtenir un utilisateur par ID
• create-user - Créer un nouvel utilisateur
• update-user - Mettre à jour un utilisateur existant
• delete-user - Supprimer un utilisateur

💡 Possibilités d’extension

Ce projet n’est qu’un point de départ. Le MCP ouvre la voie à :

• Intégration avec des systèmes CRM complexes
• Automatisation de workflows multi-étapes
• Création d’agents IA spécialisés pour vos données
• Interfaces conversationnelles pour tous vos outils internes

📖 Documentation MCP

Pour en savoir plus sur le Model Context Protocol :
Documentation officielle MCP# mcp-exemple