@lyrra/mcp-server 1.0.0 → 1.1.0

package/src/tools/eduflow.ts

@@ -1,12 +1,15 @@
 import { z } from 'zod';
-import { client } from '../client.js';
+import { LyrraClient } from '../client.js';
+import { client as defaultClient } from '../client.js';
+import { config } from '../config.js';
 
-export const eduflowTools = {
+export function createEduflowTools(c: LyrraClient) {
+  return {
   eduflow_list: {
     description: 'Lister tous les parcours EduFlow de l\'utilisateur. Retourne id, titre, statut, nombre de blocs, dates.',
     inputSchema: z.object({}),
     handler: async () => {
-      return client.get('/flows', 'eduflow');
+      return c.get('/flows', 'eduflow');
     },
   },
 
@@ -16,7 +19,24 @@ export const eduflowTools = {
       flowId: z.string().uuid().describe('ID du parcours EduFlow'),
     }),
     handler: async ({ flowId }: { flowId: string }) => {
-      return client.get(`/flows/${flowId}`, 'eduflow');
+      return c.get(`/flows/${flowId}`, 'eduflow');
+    },
+  },
+
+  eduflow_get_urls: {
+    description: 'Obtenir tous les liens utiles d\'un parcours EduFlow : prévisualisation, édition, page publique, analytics, lien participant. À utiliser quand l\'utilisateur demande un lien ou une URL.',
+    inputSchema: z.object({
+      flowId: z.string().uuid().describe('ID du parcours EduFlow'),
+    }),
+    handler: async ({ flowId }: { flowId: string }) => {
+      const base = config.frontendUrl;
+      return {
+        preview: `${base}/eduflow/flows/${flowId}/play`,
+        public: `${base}/eduflow/flows/${flowId}/public`,
+        edit: `${base}/eduflow/edit/${flowId}`,
+        presentation: `${base}/eduflow/edit/${flowId}/presentation`,
+        analytics: `${base}/eduflow/flows/${flowId}/analytics`,
+      };
     },
   },
 
@@ -28,7 +48,7 @@ export const eduflowTools = {
       language: z.enum(['fr', 'en', 'es', 'it', 'de']).optional().describe('Langue du parcours (défaut: fr)'),
     }),
     handler: async (args: { title: string; description?: string; language?: string }) => {
-      return client.post('/flows', args, 'eduflow');
+      return c.post('/flows', args, 'eduflow');
     },
   },
 
@@ -55,7 +75,7 @@ export const eduflowTools = {
       language: z.enum(['fr', 'en', 'es', 'it', 'de']).optional().describe('Langue du parcours'),
     }),
     handler: async ({ flowId, ...data }: any) => {
-      return client.put(`/flows/${flowId}`, data, 'eduflow');
+      return c.put(`/flows/${flowId}`, data, 'eduflow');
     },
   },
 
@@ -65,7 +85,7 @@ export const eduflowTools = {
       flowId: z.string().uuid().describe('ID du parcours à supprimer'),
     }),
     handler: async ({ flowId }: { flowId: string }) => {
-      return client.delete(`/flows/${flowId}`, 'eduflow');
+      return c.delete(`/flows/${flowId}`, 'eduflow');
     },
   },
 
@@ -75,7 +95,7 @@ export const eduflowTools = {
       flowId: z.string().uuid().describe('ID du parcours à dupliquer'),
     }),
     handler: async ({ flowId }: { flowId: string }) => {
-      return client.post(`/flows/${flowId}/duplicate`, {}, 'eduflow');
+      return c.post(`/flows/${flowId}/duplicate`, {}, 'eduflow');
     },
   },
 
@@ -86,7 +106,7 @@ export const eduflowTools = {
       status: z.enum(['draft', 'published', 'archived']).describe('Nouveau statut'),
     }),
     handler: async ({ flowId, status }: { flowId: string; status: string }) => {
-      return client.patch(`/flows/${flowId}/status`, { status }, 'eduflow');
+      return c.patch(`/flows/${flowId}/status`, { status }, 'eduflow');
     },
   },
 
@@ -96,7 +116,7 @@ export const eduflowTools = {
       flowId: z.string().uuid().describe('ID du parcours à exporter'),
     }),
     handler: async ({ flowId }: { flowId: string }) => {
-      return client.get(`/flows/${flowId}/export`, 'eduflow');
+      return c.get(`/flows/${flowId}/export`, 'eduflow');
     },
   },
 
@@ -106,7 +126,11 @@ export const eduflowTools = {
       flowId: z.string().uuid().describe('ID du parcours'),
     }),
     handler: async ({ flowId }: { flowId: string }) => {
-      return client.get(`/flows/${flowId}/public`, 'eduflow');
+      return c.get(`/flows/${flowId}/public`, 'eduflow');
     },
   },
-};
+  };
+}
+
+// Backward compatibility for stdio mode
+export const eduflowTools = createEduflowTools(defaultClient);

package/src/tools/participants.ts

@@ -1,14 +1,16 @@
 import { z } from 'zod';
-import { client } from '../client.js';
+import { LyrraClient } from '../client.js';
+import { client as defaultClient } from '../client.js';
 
-export const participantsTools = {
+export function createParticipantsTools(c: LyrraClient) {
+  return {
   participant_list: {
     description: 'Lister tous les participants/étudiants inscrits à un parcours EduFlow avec leur progression.',
     inputSchema: z.object({
       flowId: z.string().uuid().describe('ID du parcours'),
     }),
     handler: async ({ flowId }: { flowId: string }) => {
-      return client.get(`/flows/${flowId}/students`, 'eduflow');
+      return c.get(`/flows/${flowId}/students`, 'eduflow');
     },
   },
 
@@ -23,7 +25,7 @@ export const participantsTools = {
       })).describe('Liste des participants à ajouter'),
     }),
     handler: async ({ flowId, participants }: any) => {
-      return client.post(`/flows/${flowId}/students`, { students: participants }, 'eduflow');
+      return c.post(`/flows/${flowId}/students`, { students: participants }, 'eduflow');
     },
   },
 
@@ -34,7 +36,7 @@ export const participantsTools = {
       studentId: z.string().uuid().describe('ID de l\'inscription étudiant'),
     }),
     handler: async ({ flowId, studentId }: { flowId: string; studentId: string }) => {
-      return client.delete(`/flows/${flowId}/students/${studentId}`, 'eduflow');
+      return c.delete(`/flows/${flowId}/students/${studentId}`, 'eduflow');
     },
   },
 
@@ -45,7 +47,7 @@ export const participantsTools = {
       studentToken: z.string().describe('Token unique du participant'),
     }),
     handler: async ({ flowId, studentToken }: { flowId: string; studentToken: string }) => {
-      return client.get(`/eduflow/progress/stats/${flowId}/${studentToken}`);
+      return c.get(`/eduflow/progress/stats/${flowId}/${studentToken}`);
     },
   },
 
@@ -55,7 +57,7 @@ export const participantsTools = {
       participantId: z.string().uuid().describe('ID global du participant'),
     }),
     handler: async ({ participantId }: { participantId: string }) => {
-      return client.get(`/participants/${participantId}/overview`, 'eduflow');
+      return c.get(`/participants/${participantId}/overview`, 'eduflow');
     },
   },
 
@@ -65,7 +67,11 @@ export const participantsTools = {
       flowId: z.string().uuid().describe('ID du parcours'),
     }),
     handler: async ({ flowId }: { flowId: string }) => {
-      return client.get(`/eduflow/progress/stats/flow/${flowId}`);
+      return c.get(`/eduflow/progress/stats/flow/${flowId}`);
     },
   },
-};
+  };
+}
+
+// Backward compatibility for stdio mode
+export const participantsTools = createParticipantsTools(defaultClient);

package/src/tools/presentation.ts

@@ -1,14 +1,16 @@
 import { z } from 'zod';
-import { client } from '../client.js';
+import { LyrraClient } from '../client.js';
+import { client as defaultClient } from '../client.js';
 
-export const presentationTools = {
+export function createPresentationTools(c: LyrraClient) {
+  return {
   presentation_get: {
     description: 'Récupérer la page de présentation d\'un parcours EduFlow (description, objectifs, image de couverture, structure affichée).',
     inputSchema: z.object({
       flowId: z.string().uuid().describe('ID du parcours'),
     }),
     handler: async ({ flowId }: { flowId: string }) => {
-      const flow = await client.get(`/flows/${flowId}`, 'eduflow');
+      const flow = await c.get(`/flows/${flowId}`, 'eduflow');
       return {
         presentationEnabled: flow.presentationEnabled,
         presentationData: flow.presentationData,
@@ -38,7 +40,7 @@ Structure de presentationData : { heroTitle, heroSubtitle, heroImage, sections[{
       }).describe('Données de la page de présentation'),
     }),
     handler: async ({ flowId, presentationData }: any) => {
-      return client.put(`/flows/${flowId}`, { presentationData }, 'eduflow');
+      return c.put(`/flows/${flowId}`, { presentationData }, 'eduflow');
     },
   },
 
@@ -49,7 +51,11 @@ Structure de presentationData : { heroTitle, heroSubtitle, heroImage, sections[{
       enabled: z.boolean().describe('true pour activer, false pour désactiver'),
     }),
     handler: async ({ flowId, enabled }: { flowId: string; enabled: boolean }) => {
-      return client.put(`/flows/${flowId}`, { presentationEnabled: enabled }, 'eduflow');
+      return c.put(`/flows/${flowId}`, { presentationEnabled: enabled }, 'eduflow');
     },
   },
-};
+  };
+}
+
+// Backward compatibility for stdio mode
+export const presentationTools = createPresentationTools(defaultClient);

package/src/tools/projects.ts

@@ -1,12 +1,14 @@
 import { z } from 'zod';
-import { client } from '../client.js';
+import { LyrraClient } from '../client.js';
+import { client as defaultClient } from '../client.js';
 
-export const projectsTools = {
+export function createProjectsTools(c: LyrraClient) {
+  return {
   project_list: {
     description: 'Lister tous les projets audio de l\'utilisateur (PDF convertis en audio).',
     inputSchema: z.object({}),
     handler: async () => {
-      return client.get('/projects');
+      return c.get('/projects');
     },
   },
 
@@ -16,7 +18,7 @@ export const projectsTools = {
       projectId: z.string().uuid().describe('ID du projet'),
     }),
     handler: async ({ projectId }: { projectId: string }) => {
-      return client.get(`/projects/${projectId}`);
+      return c.get(`/projects/${projectId}`);
     },
   },
 
@@ -27,7 +29,7 @@ export const projectsTools = {
       description: z.string().optional().describe('Description'),
     }),
     handler: async (data: any) => {
-      return client.post('/projects', data);
+      return c.post('/projects', data);
     },
   },
 
@@ -39,7 +41,7 @@ export const projectsTools = {
       description: z.string().optional().describe('Nouvelle description'),
     }),
     handler: async ({ projectId, ...data }: any) => {
-      return client.put(`/projects/${projectId}`, data);
+      return c.put(`/projects/${projectId}`, data);
     },
   },
 
@@ -49,7 +51,11 @@ export const projectsTools = {
       projectId: z.string().uuid().describe('ID du projet à supprimer'),
     }),
     handler: async ({ projectId }: { projectId: string }) => {
-      return client.delete(`/projects/${projectId}`);
+      return c.delete(`/projects/${projectId}`);
     },
   },
-};
+  };
+}
+
+// Backward compatibility for stdio mode
+export const projectsTools = createProjectsTools(defaultClient);

package/src/tools/resources.ts

@@ -1,14 +1,16 @@
 import { z } from 'zod';
-import { client } from '../client.js';
+import { LyrraClient } from '../client.js';
+import { client as defaultClient } from '../client.js';
 
-export const resourcesTools = {
+export function createResourcesTools(c: LyrraClient) {
+  return {
   resource_list: {
     description: 'Lister les ressources de l\'utilisateur (images, documents, sons, vidéos) avec pagination.',
     inputSchema: z.object({
       type: z.enum(['images', 'documents', 'sounds', 'videos']).describe('Type de ressource'),
     }),
     handler: async ({ type }: { type: string }) => {
-      return client.get(`/user-resources/${type}`);
+      return c.get(`/user-resources/${type}`);
     },
   },
 
@@ -19,7 +21,7 @@ export const resourcesTools = {
       resourceId: z.string().uuid().describe('ID de la ressource'),
     }),
     handler: async ({ type, resourceId }: { type: string; resourceId: string }) => {
-      return client.delete(`/user-resources/${type}/${resourceId}`);
+      return c.delete(`/user-resources/${type}/${resourceId}`);
     },
   },
 
@@ -29,7 +31,11 @@ export const resourcesTools = {
       type: z.enum(['images', 'documents', 'sounds', 'videos']).describe('Type de ressource'),
     }),
     handler: async ({ type }: { type: string }) => {
-      return client.get(`/categories/${type}`);
+      return c.get(`/categories/${type}`);
     },
   },
-};
+  };
+}
+
+// Backward compatibility for stdio mode
+export const resourcesTools = createResourcesTools(defaultClient);

package/src/tools/store.ts

@@ -1,7 +1,9 @@
 import { z } from 'zod';
-import { client } from '../client.js';
+import { LyrraClient } from '../client.js';
+import { client as defaultClient } from '../client.js';
 
-export const storeTools = {
+export function createStoreTools(c: LyrraClient) {
+  return {
   store_list_audiobooks: {
     description: 'Lister les audiobooks disponibles dans le store LYRRA. Supporte la pagination, recherche et filtres.',
     inputSchema: z.object({
@@ -19,7 +21,7 @@ export const storeTools = {
       if (category) params.set('category', category);
       if (featured) params.set('featured', 'true');
       const query = params.toString() ? `?${params}` : '';
-      return client.post(`/store/public/audiobooks${query}`, {});
+      return c.post(`/store/public/audiobooks${query}`, {});
     },
   },
 
@@ -29,7 +31,7 @@ export const storeTools = {
       audiobookId: z.string().describe('ID de l\'audiobook'),
     }),
     handler: async ({ audiobookId }: { audiobookId: string }) => {
-      return client.get(`/store/public/audiobooks/${audiobookId}`);
+      return c.get(`/store/public/audiobooks/${audiobookId}`);
     },
   },
 
@@ -37,7 +39,7 @@ export const storeTools = {
     description: 'Lister les auteurs mis en avant sur le store.',
     inputSchema: z.object({}),
     handler: async () => {
-      return client.get('/store/public/authors/featured');
+      return c.get('/store/public/authors/featured');
     },
   },
 
@@ -45,7 +47,7 @@ export const storeTools = {
     description: 'Récupérer ma bibliothèque d\'audiobooks achetés.',
     inputSchema: z.object({}),
     handler: async () => {
-      return client.get('/store/my-library');
+      return c.get('/store/my-library');
     },
   },
 
@@ -55,7 +57,11 @@ export const storeTools = {
       query: z.string().describe('Terme de recherche'),
     }),
     handler: async ({ query }: { query: string }) => {
-      return client.post('/store/public/audiobooks', { search: query });
+      return c.post('/store/public/audiobooks', { search: query });
     },
   },
-};
+  };
+}
+
+// Backward compatibility for stdio mode
+export const storeTools = createStoreTools(defaultClient);