@lyrra/mcp-server 1.0.1 → 1.1.1

package/src/server-factory.ts

@@ -0,0 +1,109 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { LyrraClient } from './client.js';
+
+// Tool factory functions
+import { createAuthTools } from './tools/auth.js';
+import { createEduflowTools } from './tools/eduflow.js';
+import { createBlocksTools } from './tools/blocks.js';
+import { createConnectionsTools } from './tools/connections.js';
+import { createParticipantsTools } from './tools/participants.js';
+import { createAnalyticsTools } from './tools/analytics.js';
+import { createAiDesignerTools } from './tools/ai-designer.js';
+import { createPresentationTools } from './tools/presentation.js';
+import { createStoreTools } from './tools/store.js';
+import { createProjectsTools } from './tools/projects.js';
+import { createResourcesTools } from './tools/resources.js';
+import { createAdminTools } from './tools/admin.js';
+
+// Resources
+import { BLOCK_TYPES_RESOURCE } from './resources/block-types.js';
+import { FLOW_SCHEMA_RESOURCE } from './resources/flow-schema.js';
+
+type ToolDef = { description: string; inputSchema: any; handler: (args: any) => Promise<any> };
+
+function registerToolsOnServer(server: McpServer, tools: Record<string, ToolDef>) {
+  for (const [name, tool] of Object.entries(tools)) {
+    server.tool(
+      name,
+      tool.description,
+      tool.inputSchema.shape
+        ? Object.fromEntries(
+            Object.entries(tool.inputSchema.shape).map(([key, schema]: [string, any]) => [key, schema])
+          )
+        : {},
+      async (args: any) => {
+        try {
+          const result = await tool.handler(args);
+          return {
+            content: [{ type: 'text' as const, text: JSON.stringify(result, null, 2) }],
+          };
+        } catch (error: any) {
+          return {
+            content: [{ type: 'text' as const, text: `Erreur: ${error.message}` }],
+            isError: true,
+          };
+        }
+      }
+    );
+  }
+}
+
+/**
+ * Create and configure an MCP server with all tools registered.
+ * @param client - LyrraClient to use for API calls. If not provided, uses default (env vars).
+ */
+export function createMcpServer(client?: LyrraClient): McpServer {
+  const c = client || new LyrraClient();
+
+  const server = new McpServer({
+    name: 'lyrra-studio',
+    version: '1.0.0',
+    description: 'Serveur MCP pour piloter LYRRA Studio - Plateforme EdTech de création de parcours pédagogiques, conversion PDF→Audio, et store d\'audiobooks.',
+  });
+
+  const allTools: Record<string, ToolDef> = {
+    ...createAuthTools(c),
+    ...createEduflowTools(c),
+    ...createBlocksTools(c),
+    ...createConnectionsTools(c),
+    ...createParticipantsTools(c),
+    ...createAnalyticsTools(c),
+    ...createAiDesignerTools(c),
+    ...createPresentationTools(c),
+    ...createStoreTools(c),
+    ...createProjectsTools(c),
+    ...createResourcesTools(c),
+    ...createAdminTools(c),
+  };
+
+  registerToolsOnServer(server, allTools);
+
+  // Resources
+  server.resource(
+    'block-types',
+    BLOCK_TYPES_RESOURCE.uri,
+    { description: BLOCK_TYPES_RESOURCE.description, mimeType: BLOCK_TYPES_RESOURCE.mimeType },
+    async () => ({
+      contents: [{
+        uri: BLOCK_TYPES_RESOURCE.uri,
+        mimeType: BLOCK_TYPES_RESOURCE.mimeType,
+        text: JSON.stringify(BLOCK_TYPES_RESOURCE.content, null, 2),
+      }],
+    })
+  );
+
+  server.resource(
+    'flow-construction-guide',
+    FLOW_SCHEMA_RESOURCE.uri,
+    { description: FLOW_SCHEMA_RESOURCE.description, mimeType: FLOW_SCHEMA_RESOURCE.mimeType },
+    async () => ({
+      contents: [{
+        uri: FLOW_SCHEMA_RESOURCE.uri,
+        mimeType: FLOW_SCHEMA_RESOURCE.mimeType,
+        text: JSON.stringify(FLOW_SCHEMA_RESOURCE.content, null, 2),
+      }],
+    })
+  );
+
+  return server;
+}

package/src/tools/admin.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 adminTools = {
+export function createAdminTools(c: LyrraClient) {
+  return {
   // --- Versions ---
   version_list: {
     description: 'Lister toutes les versions d\'un parcours EduFlow.',
@@ -9,7 +11,7 @@ export const adminTools = {
       flowId: z.string().uuid().describe('ID du parcours'),
     }),
     handler: async ({ flowId }: { flowId: string }) => {
-      return client.get(`/flows/${flowId}/versions`, 'eduflow');
+      return c.get(`/flows/${flowId}/versions`, 'eduflow');
     },
   },
 
@@ -20,7 +22,7 @@ export const adminTools = {
       versionLabel: z.string().optional().describe('Label de la version (ex: "v2.0 - Ajout quiz")'),
     }),
     handler: async ({ flowId, versionLabel }: any) => {
-      return client.post(`/flows/${flowId}/versions`, { versionLabel }, 'eduflow');
+      return c.post(`/flows/${flowId}/versions`, { versionLabel }, 'eduflow');
     },
   },
 
@@ -31,7 +33,7 @@ export const adminTools = {
       versionId: z.string().uuid().describe('ID de la version à activer'),
     }),
     handler: async ({ flowId, versionId }: { flowId: string; versionId: string }) => {
-      return client.post(`/flows/${flowId}/versions/${versionId}/activate`, {}, 'eduflow');
+      return c.post(`/flows/${flowId}/versions/${versionId}/activate`, {}, 'eduflow');
     },
   },
 
@@ -40,7 +42,7 @@ export const adminTools = {
     description: 'Récupérer les statistiques de gamification de l\'utilisateur (niveau, streak, badges, missions).',
     inputSchema: z.object({}),
     handler: async () => {
-      return client.get('/gamification/stats');
+      return c.get('/gamification/stats');
     },
   },
 
@@ -48,7 +50,7 @@ export const adminTools = {
     description: 'Récupérer les prochains objectifs de gamification à atteindre.',
     inputSchema: z.object({}),
     handler: async () => {
-      return client.get('/gamification/objectives');
+      return c.get('/gamification/objectives');
     },
   },
 
@@ -64,7 +66,7 @@ export const adminTools = {
       if (page) params.set('page', String(page));
       if (limit) params.set('limit', String(limit));
       const query = params.toString() ? `?${params}` : '';
-      return client.get(`/activity${query}`);
+      return c.get(`/activity${query}`);
     },
   },
 
@@ -75,7 +77,7 @@ export const adminTools = {
     }),
     handler: async ({ period }: { period?: string }) => {
       const query = period ? `?period=${period}` : '';
-      return client.get(`/activity/stats${query}`);
+      return c.get(`/activity/stats${query}`);
     },
   },
 
@@ -84,7 +86,7 @@ export const adminTools = {
     description: 'Lister les webhooks configurés pour recevoir des événements (block.completed, flow.completed, etc.).',
     inputSchema: z.object({}),
     handler: async () => {
-      return client.get('/webhooks');
+      return c.get('/webhooks');
     },
   },
 
@@ -96,7 +98,7 @@ export const adminTools = {
       name: z.string().optional().describe('Nom du webhook'),
     }),
     handler: async (data: any) => {
-      return client.post('/webhooks', data);
+      return c.post('/webhooks', data);
     },
   },
 
@@ -106,7 +108,7 @@ export const adminTools = {
       webhookId: z.string().uuid().describe('ID du webhook'),
     }),
     handler: async ({ webhookId }: { webhookId: string }) => {
-      return client.delete(`/webhooks/${webhookId}`);
+      return c.delete(`/webhooks/${webhookId}`);
     },
   },
 
@@ -116,7 +118,11 @@ export const adminTools = {
       webhookId: z.string().uuid().describe('ID du webhook à tester'),
     }),
     handler: async ({ webhookId }: { webhookId: string }) => {
-      return client.post(`/webhooks/${webhookId}/test`, {});
+      return c.post(`/webhooks/${webhookId}/test`, {});
     },
   },
-};
+  };
+}
+
+// Backward compatibility for stdio mode
+export const adminTools = createAdminTools(defaultClient);

package/src/tools/ai-designer.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 aiDesignerTools = {
+export function createAiDesignerTools(c: LyrraClient) {
+  return {
   ai_generate_plan: {
     description: 'Générer automatiquement un plan/structure de parcours pédagogique à partir d\'un sujet et d\'objectifs. L\'IA propose une liste de blocs organisés.',
     inputSchema: z.object({
@@ -13,7 +15,7 @@ export const aiDesignerTools = {
       context: z.string().optional().describe('Contexte additionnel pour l\'IA'),
     }),
     handler: async ({ flowId, ...data }: any) => {
-      return client.post(`/flows/${flowId}/chatbot/generate-plan`, data, 'eduflow');
+      return c.post(`/flows/${flowId}/chatbot/generate-plan`, data, 'eduflow');
     },
   },
 
@@ -26,7 +28,7 @@ export const aiDesignerTools = {
       context: z.string().optional().describe('Contexte du parcours pour l\'IA'),
     }),
     handler: async ({ flowId, ...data }: any) => {
-      return client.post(`/flows/${flowId}/chatbot/generate-block`, data, 'eduflow');
+      return c.post(`/flows/${flowId}/chatbot/generate-block`, data, 'eduflow');
     },
   },
 
@@ -37,7 +39,7 @@ export const aiDesignerTools = {
       style: z.string().optional().describe('Style de présentation souhaité'),
     }),
     handler: async ({ flowId, ...data }: any) => {
-      return client.post(`/flows/${flowId}/chatbot/generate-presentation`, data, 'eduflow');
+      return c.post(`/flows/${flowId}/chatbot/generate-presentation`, data, 'eduflow');
     },
   },
 
@@ -47,7 +49,7 @@ export const aiDesignerTools = {
       flowId: z.string().uuid().describe('ID du parcours'),
     }),
     handler: async ({ flowId }: { flowId: string }) => {
-      return client.post(`/flows/${flowId}/chatbot/generate-objectives`, {}, 'eduflow');
+      return c.post(`/flows/${flowId}/chatbot/generate-objectives`, {}, 'eduflow');
     },
   },
 
@@ -64,7 +66,7 @@ export const aiDesignerTools = {
       })).describe('Liste des objectifs par étape'),
     }),
     handler: async ({ flowId, ...objectives }: any) => {
-      return client.post(`/flows/${flowId}/chatbot/save-objectives`, objectives, 'eduflow');
+      return c.post(`/flows/${flowId}/chatbot/save-objectives`, objectives, 'eduflow');
     },
   },
 
@@ -75,7 +77,7 @@ export const aiDesignerTools = {
       message: z.string().describe('Message à envoyer à l\'IA designer'),
     }),
     handler: async ({ flowId, message }: { flowId: string; message: string }) => {
-      return client.post(`/flows/${flowId}/chatbot/message`, { message }, 'eduflow');
+      return c.post(`/flows/${flowId}/chatbot/message`, { message }, 'eduflow');
     },
   },
 
@@ -85,7 +87,11 @@ export const aiDesignerTools = {
       flowId: z.string().uuid().describe('ID du parcours'),
     }),
     handler: async ({ flowId }: { flowId: string }) => {
-      return client.get(`/flows/${flowId}/chatbot/conversation`, 'eduflow');
+      return c.get(`/flows/${flowId}/chatbot/conversation`, 'eduflow');
     },
   },
-};
+  };
+}
+
+// Backward compatibility for stdio mode
+export const aiDesignerTools = createAiDesignerTools(defaultClient);

package/src/tools/analytics.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 analyticsTools = {
+export function createAnalyticsTools(c: LyrraClient) {
+  return {
   analytics_overview: {
     description: 'Tableau de bord global : nombre de projets, parcours EduFlow, apprenants, crédits utilisés, avec évolution par période.',
     inputSchema: z.object({
@@ -9,7 +11,7 @@ export const analyticsTools = {
     }),
     handler: async ({ period }: { period?: string }) => {
       const query = period ? `?period=${period}` : '';
-      return client.get(`/analytics/overview${query}`);
+      return c.get(`/analytics/overview${query}`);
     },
   },
 
@@ -19,7 +21,7 @@ export const analyticsTools = {
       flowId: z.string().uuid().describe('ID du parcours'),
     }),
     handler: async ({ flowId }: { flowId: string }) => {
-      return client.get(`/analytics/flow/${flowId}/learners`);
+      return c.get(`/analytics/flow/${flowId}/learners`);
     },
   },
 
@@ -29,7 +31,7 @@ export const analyticsTools = {
       flowId: z.string().uuid().describe('ID du parcours'),
     }),
     handler: async ({ flowId }: { flowId: string }) => {
-      return client.get(`/flows/${flowId}/analytics`, 'eduflow');
+      return c.get(`/flows/${flowId}/analytics`, 'eduflow');
     },
   },
 
@@ -37,7 +39,11 @@ export const analyticsTools = {
     description: 'Mes statistiques personnelles : projets créés, parcours créés, temps total, crédits utilisés.',
     inputSchema: z.object({}),
     handler: async () => {
-      return client.get('/analytics/my-stats');
+      return c.get('/analytics/my-stats');
     },
   },
-};
+  };
+}
+
+// Backward compatibility for stdio mode
+export const analyticsTools = createAnalyticsTools(defaultClient);

package/src/tools/auth.ts

@@ -1,33 +1,39 @@
 import { z } from 'zod';
-import { client } from '../client.js';
+import { LyrraClient } from '../client.js';
+import { client as defaultClient } from '../client.js';
 
-export const authTools = {
-  auth_login: {
-    description: 'Se connecter à LYRRA Studio avec email et mot de passe. ⚠️ NE PAS utiliser si LYRRA_CLIENT_SECRET est configuré — l\'authentification est alors automatique via API Key. Utiliser uniquement si aucune clé API n\'est définie.',
-    inputSchema: z.object({
-      email: z.string().email().describe('Adresse email du compte'),
-      password: z.string().describe('Mot de passe'),
-    }),
-    handler: async ({ email, password }: { email: string; password: string }) => {
-      const result = await client.post('/auth/login', { email, password });
-      if (result.token) client.setToken(result.token);
-      return result;
+export function createAuthTools(c: LyrraClient) {
+  return {
+    auth_login: {
+      description: 'Se connecter à LYRRA Studio avec email et mot de passe. ⚠️ NE PAS utiliser si LYRRA_CLIENT_SECRET est configuré — l\'authentification est alors automatique via API Key. Utiliser uniquement si aucune clé API n\'est définie.',
+      inputSchema: z.object({
+        email: z.string().email().describe('Adresse email du compte'),
+        password: z.string().describe('Mot de passe'),
+      }),
+      handler: async ({ email, password }: { email: string; password: string }) => {
+        const result = await c.post('/auth/login', { email, password });
+        if (result.token) c.setToken(result.token);
+        return result;
+      },
     },
-  },
 
-  auth_get_profile: {
-    description: 'Récupérer le profil de l\'utilisateur connecté (nom, email, crédits, rôle, institution, etc.).',
-    inputSchema: z.object({}),
-    handler: async () => {
-      return client.get('/auth/me');
+    auth_get_profile: {
+      description: 'Récupérer le profil de l\'utilisateur connecté (nom, email, crédits, rôle, institution, etc.).',
+      inputSchema: z.object({}),
+      handler: async () => {
+        return c.get('/auth/me');
+      },
     },
-  },
 
-  auth_list_api_keys: {
-    description: 'Lister toutes les clés API de l\'utilisateur connecté.',
-    inputSchema: z.object({}),
-    handler: async () => {
-      return client.get('/api-keys');
+    auth_list_api_keys: {
+      description: 'Lister toutes les clés API de l\'utilisateur connecté.',
+      inputSchema: z.object({}),
+      handler: async () => {
+        return c.get('/api-keys');
+      },
     },
-  },
-};
+  };
+}
+
+// Backward compatibility for stdio mode
+export const authTools = createAuthTools(defaultClient);

package/src/tools/blocks.ts

@@ -1,11 +1,13 @@
 import { z } from 'zod';
-import { client } from '../client.js';
+import { LyrraClient } from '../client.js';
+import { client as defaultClient } from '../client.js';
 
 const blockContentSchema = z.record(z.any()).describe(
   'Contenu du bloc (structure variable selon le type). Utiliser la resource lyrra://block-types pour connaître la structure attendue.'
 );
 
-export const blocksTools = {
+export function createBlocksTools(c: LyrraClient) {
+  return {
   block_list_types: {
     description: `Lister tous les types de blocs disponibles avec leur documentation complète.
 Types disponibles : text, audio, quiz, video, pdf, image, loop, evaluation, split, merge, timer, start, end, chart, timeline, dys_reader, dys_image_zones, dys_reading_practice, dys_clock, glossary, subflow, mindmap, form, certification, email, voice_assessment, presentation, browser, self_assessment.
@@ -55,7 +57,7 @@ Utiliser plutôt la resource lyrra://block-types pour la documentation complète
       blockId: z.string().uuid().describe('ID du bloc'),
     }),
     handler: async ({ flowId, blockId }: { flowId: string; blockId: string }) => {
-      return client.get(`/flows/${flowId}/blocks/${blockId}`, 'eduflow');
+      return c.get(`/flows/${flowId}/blocks/${blockId}`, 'eduflow');
     },
   },
 
@@ -79,7 +81,7 @@ IMPORTANT pour le type "text" : toujours utiliser content.format = "html" et du
     }),
     handler: async ({ flowId, ...blockData }: any) => {
       // Use batch update to add a single block
-      const flow = await client.get(`/flows/${flowId}`, 'eduflow');
+      const flow = await c.get(`/flows/${flowId}`, 'eduflow');
       const existingBlocks = flow.blocks || [];
       const newBlock = {
         id: crypto.randomUUID(),
@@ -93,7 +95,7 @@ IMPORTANT pour le type "text" : toujours utiliser content.format = "html" et du
         content: b.content, positionX: b.positionX, positionY: b.positionY,
         order: b.order, conditions: b.conditions, comment: b.comment,
       })), newBlock];
-      await client.put(`/flows/${flowId}/blocks`, allBlocks, 'eduflow');
+      await c.put(`/flows/${flowId}/blocks`, allBlocks, 'eduflow');
       return { success: true, block: newBlock };
     },
   },
@@ -112,7 +114,7 @@ IMPORTANT pour le type "text" : toujours utiliser content.format = "html" et du
       comment: z.string().optional().describe('Commentaire créateur'),
     }),
     handler: async ({ flowId, blockId, ...data }: any) => {
-      return client.put(`/flows/${flowId}/blocks/${blockId}`, data, 'eduflow');
+      return c.put(`/flows/${flowId}/blocks/${blockId}`, data, 'eduflow');
     },
   },
 
@@ -133,7 +135,7 @@ IMPORTANT pour le type "text" : toujours utiliser content.format = "html" et du
       })).describe('Liste complète des blocs (REMPLACE tous les blocs existants)'),
     }),
     handler: async ({ flowId, blocks }: any) => {
-      return client.put(`/flows/${flowId}/blocks`, blocks, 'eduflow');
+      return c.put(`/flows/${flowId}/blocks`, blocks, 'eduflow');
     },
   },
 
@@ -145,7 +147,7 @@ IMPORTANT pour le type "text" : toujours utiliser content.format = "html" et du
     }),
     handler: async ({ flowId, blockId }: { flowId: string; blockId: string }) => {
       // Get current flow, remove block, remove related edges, batch update
-      const flow = await client.get(`/flows/${flowId}`, 'eduflow');
+      const flow = await c.get(`/flows/${flowId}`, 'eduflow');
       const blocks = (flow.blocks || []).filter((b: any) => b.id !== blockId);
       const edges = (flow.edges || []).filter(
         (e: any) => e.source !== blockId && e.target !== blockId
@@ -155,8 +157,8 @@ IMPORTANT pour le type "text" : toujours utiliser content.format = "html" et du
         content: b.content, positionX: b.positionX, positionY: b.positionY,
         order: b.order, conditions: b.conditions, comment: b.comment,
       }));
-      await client.put(`/flows/${flowId}/blocks`, mappedBlocks, 'eduflow');
-      await client.put(`/flows/${flowId}`, { edges }, 'eduflow');
+      await c.put(`/flows/${flowId}/blocks`, mappedBlocks, 'eduflow');
+      await c.put(`/flows/${flowId}`, { edges }, 'eduflow');
       return { success: true, remainingBlocks: blocks.length, remainingEdges: edges.length };
     },
   },
@@ -168,7 +170,11 @@ IMPORTANT pour le type "text" : toujours utiliser content.format = "html" et du
       blockId: z.string().uuid().describe('ID du bloc'),
     }),
     handler: async ({ flowId, blockId }: { flowId: string; blockId: string }) => {
-      return client.post(`/blocks/${blockId}/generate-tts`, { flowId }, 'eduflow');
+      return c.post(`/blocks/${blockId}/generate-tts`, { flowId }, 'eduflow');
     },
   },
-};
+  };
+}
+
+// Backward compatibility for stdio mode
+export const blocksTools = createBlocksTools(defaultClient);

package/src/tools/connections.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 connectionsTools = {
+export function createConnectionsTools(c: LyrraClient) {
+  return {
   connection_list: {
     description: `Lister toutes les connexions (edges) d'un parcours EduFlow. Chaque connexion relie un bloc source à un bloc cible.
 Règles de connexion :
@@ -14,7 +16,7 @@ Règles de connexion :
       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 {
         edges: flow.edges || [],
         blocks: (flow.blocks || []).map((b: any) => ({ id: b.id, type: b.type, title: b.title })),
@@ -32,7 +34,7 @@ Règles de connexion :
       animated: z.boolean().optional().describe('Animer la connexion visuellement'),
     }),
     handler: async ({ flowId, source, target, label, animated }: any) => {
-      const flow = await client.get(`/flows/${flowId}`, 'eduflow');
+      const flow = await c.get(`/flows/${flowId}`, 'eduflow');
       const edges = flow.edges || [];
       const newEdge = {
         id: `e-${source}-${target}`,
@@ -47,7 +49,7 @@ Règles de connexion :
         return { success: false, error: 'Cette connexion existe déjà' };
       }
       edges.push(newEdge);
-      await client.put(`/flows/${flowId}`, { edges }, 'eduflow');
+      await c.put(`/flows/${flowId}`, { edges }, 'eduflow');
       return { success: true, edge: newEdge, totalEdges: edges.length };
     },
   },
@@ -61,7 +63,7 @@ Règles de connexion :
       target: z.string().optional().describe('Alternative : ID du bloc cible'),
     }),
     handler: async ({ flowId, edgeId, source, target }: any) => {
-      const flow = await client.get(`/flows/${flowId}`, 'eduflow');
+      const flow = await c.get(`/flows/${flowId}`, 'eduflow');
       let edges = flow.edges || [];
       if (edgeId) {
         edges = edges.filter((e: any) => e.id !== edgeId);
@@ -70,8 +72,12 @@ Règles de connexion :
       } else {
         return { success: false, error: 'Fournir edgeId OU source+target' };
       }
-      await client.put(`/flows/${flowId}`, { edges }, 'eduflow');
+      await c.put(`/flows/${flowId}`, { edges }, 'eduflow');
       return { success: true, remainingEdges: edges.length };
     },
   },
-};
+  };
+}
+
+// Backward compatibility for stdio mode
+export const connectionsTools = createConnectionsTools(defaultClient);