Task Manager MCP Server

Serveur MCP (Model Context Protocol) basé sur Spring Boot pour la gestion de projets et de tâches, utilisant MongoDB comme base de données.

Prérequis

• Java Development Kit (JDK) 21 ou supérieur
• Gradle 8+ (le wrapper Gradle ./gradlew est inclus)
• Accès à une instance MongoDB (locale ou distante). Par défaut, il tente de se connecter à mongodb://localhost:27017/task_manager_mcp_db.

Configuration

La configuration principale se trouve dans src/main/resources/application.properties.

• spring.data.mongodb.uri: Modifiez cette ligne pour pointer vers votre instance MongoDB.

  # Exemple pour une instance locale
  spring.data.mongodb.uri=mongodb://localhost:27017/task_manager_mcp_db
  
  # Exemple pour MongoDB Atlas (remplacez par vos identifiants et adresse)
  # spring.data.mongodb.uri=mongodb+srv://<username>:<password>@<cluster-address>/<database_name>?retryWrites=true&w=majority
  

• spring.application.name: Nom de l'application (utilisé par Spring Boot).

• server.port: Port HTTP sur lequel l'application écoute (si le module Web est utilisé activement, par défaut 8080). Pour le serveur MCP Stdio, ce port n'est pas directement utilisé pour la communication principale.

Build

Pour construire l'application et créer un JAR exécutable :

# Depuis le répertoire racine du projet (task-manager-mcp)
./gradlew build

Le JAR exécutable se trouvera dans build/libs/task-manager-mcp-0.0.1-SNAPSHOT.jar.

Exécution (Serveur MCP Stdio)

Le serveur est conçu pour communiquer via l'entrée/sortie standard (stdin/stdout). Lancez le JAR généré :

java -jar build/libs/task-manager-mcp-0.0.1-SNAPSHOT.jar

Le serveur attendra ensuite des requêtes JSON sur son entrée standard et enverra des réponses JSON sur sa sortie standard.

Outils MCP Disponibles

Le serveur expose les outils suivants via le protocole MCP. Les requêtes et réponses sont au format JSON.

Format Requête Générale:

{
  "tool_name": "nom_de_l_outil",
  "arguments": { ... }
}

Format Réponse Générale (Succès):

{
  "result": { ... } // ou une chaîne de confirmation, ou une liste
}

Format Réponse Générale (Erreur):

{
  "error": {
    "type": "Type d'erreur (e.g., Validation Error, Not Found)",
    "message": "Description de l'erreur"
  }
}

Outils Projet

• create_project
  • Arguments: { "name": "...", "description": "...", "code": "..." } (description optionnelle)
  • Résultat: { "id": "...", "name": "...", "description": "...", "code": "..." } (le projet créé)
• get_project
  • Arguments: { "code": "..." }
  • Résultat: { "id": "...", "name": "...", "description": "...", "code": "..." } (le projet trouvé)
• update_project
  • Arguments: { "code": "...", "name": "...", "description": "..." } (seuls name et description sont mis à jour)
  • Résultat: { "id": "...", "name": "...", "description": "...", "code": "..." } (le projet mis à jour)
• delete_project
  • Arguments: { "code": "..." }
  • Résultat: "Project with code '...' deleted successfully."
• list_projects
  • Arguments: {} (ou absents)
  • Résultat: [ { "id": "...", ... }, ... ] (liste des projets)

Outils Tâche

• create_task
  • Arguments: { "projectCode": "...", "summary": "...", "description": "...", "estimate": ..., "plannedStartDate": "YYYY-MM-DD", "plannedEndDate": "YYYY-MM-DD" } (description, plannedStartDate, plannedEndDate optionnels)
  • Résultat: { "id": "...", "key": "...", "summary": "...", ... } (la tâche créée avec sa clé générée)
• get_task
  • Arguments: { "key": "..." }
  • Résultat: { "id": "...", "key": "...", ... } (la tâche trouvée)
• update_task
  • Arguments: { "key": "...", "projectCode": "...", "summary": "...", "description": "...", "estimate": ..., "realisationTime": ..., "plannedStartDate": "YYYY-MM-DD", "plannedEndDate": "YYYY-MM-DD", "status": "..." } (tous les champs sauf key peuvent être mis à jour)
  • Résultat: { "id": "...", "key": "...", ... } (la tâche mise à jour)
• delete_task
  • Arguments: { "key": "..." }
  • Résultat: "Task with key '...' deleted successfully."
• list_tasks
  • Arguments: { "projectCode": "..." }
  • Résultat: [ { "id": "...", "key": "...", ... }, ... ] (liste des tâches pour le projet)