@shoppexio/mcp-theme-server 0.1.3 → 0.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shoppexio/mcp-theme-server",
-  "version": "0.1.3",
+  "version": "0.3.0",
   "description": "Shoppex MCP server for theme control plane operations",
   "type": "module",
   "repository": {
@@ -38,6 +38,6 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.28.0",
-    "@shoppexio/theme-control-client": "^0.1.0"
+    "@shoppexio/theme-control-client": "^0.2.0"
   }
 }

package/src/server.mjs

@@ -22,7 +22,13 @@ function jsonContent(value) {
 export function createThemeToolCatalog() {
   return [
     {
-      name: 'theme.inspect',
+      name: 'theme_list',
+      description: 'List all themes belonging to the authenticated shop. Returns id, name, scheme, version, is_active, preview_url for each theme. Use this first when the user asks about a theme by name — find the id, then call theme_inspect.',
+      inputSchema: {},
+      execute: (_args, client) => client.listThemes(),
+    },
+    {
+      name: 'theme_inspect',
       description: 'Inspect a Shoppex theme and return editable areas, sections, settings, design tokens, and constraints.',
       inputSchema: {
         theme_id: z.string().min(1),
@@ -30,7 +36,7 @@ export function createThemeToolCatalog() {
       execute: ({ theme_id }, client) => client.inspectTheme(theme_id),
     },
     {
-      name: 'theme.diff',
+      name: 'theme_diff',
       description: 'Show changes between the current draft and the latest published theme snapshot.',
       inputSchema: {
         theme_id: z.string().min(1),
@@ -38,7 +44,7 @@ export function createThemeToolCatalog() {
       execute: ({ theme_id }, client) => client.diffTheme(theme_id),
     },
     {
-      name: 'theme.read_file',
+      name: 'theme_read_file',
       description: 'Read a single source file from a Shoppex theme.',
       inputSchema: {
         theme_id: z.string().min(1),
@@ -47,7 +53,7 @@ export function createThemeToolCatalog() {
       execute: ({ theme_id, file_path }, client) => client.readThemeFile(theme_id, file_path),
     },
     {
-      name: 'theme.search_files',
+      name: 'theme_search_files',
       description: 'Search theme files by path or content.',
       inputSchema: {
         theme_id: z.string().min(1),
@@ -57,7 +63,7 @@ export function createThemeToolCatalog() {
       execute: ({ theme_id, query, limit }, client) => client.searchThemeFiles(theme_id, query, limit),
     },
     {
-      name: 'theme.apply',
+      name: 'theme_apply',
       description: 'Apply one or more text-file changes to a theme draft with server-side verification.',
       inputSchema: {
         theme_id: z.string().min(1),
@@ -75,7 +81,7 @@ export function createThemeToolCatalog() {
       }),
     },
     {
-      name: 'theme.accept',
+      name: 'theme_accept',
       description: 'Accept an already generated draft patch from a dashboard-agent run.',
       inputSchema: {
         theme_id: z.string().min(1),
@@ -90,7 +96,7 @@ export function createThemeToolCatalog() {
       }),
     },
     {
-      name: 'theme.create',
+      name: 'theme_create',
       description: 'Create a new theme scaffold from a Shoppex base theme.',
       inputSchema: {
         base: z.enum(['default', 'classic', 'nebula', 'pulse', 'phantom', 'starlight']),
@@ -104,7 +110,7 @@ export function createThemeToolCatalog() {
       }),
     },
     {
-      name: 'theme.create_section',
+      name: 'theme_create_section',
       description: 'Scaffold a new theme section and wire it into theme.config.ts.',
       inputSchema: {
         theme_id: z.string().min(1),
@@ -119,7 +125,7 @@ export function createThemeToolCatalog() {
       }),
     },
     {
-      name: 'theme.create_page',
+      name: 'theme_create_page',
       description: 'Scaffold a new static page and wire its route into src/App.tsx.',
       inputSchema: {
         theme_id: z.string().min(1),
@@ -134,7 +140,7 @@ export function createThemeToolCatalog() {
       }),
     },
     {
-      name: 'theme.update_config',
+      name: 'theme_update_config',
       description: 'Extend theme.config.ts with a new settings field.',
       inputSchema: {
         theme_id: z.string().min(1),
@@ -149,7 +155,7 @@ export function createThemeToolCatalog() {
       }),
     },
     {
-      name: 'theme.preview',
+      name: 'theme_preview',
       description: 'Start or reuse a live preview session for the current theme draft.',
       inputSchema: {
         theme_id: z.string().min(1),
@@ -157,7 +163,7 @@ export function createThemeToolCatalog() {
       execute: ({ theme_id }, client) => client.startThemePreview(theme_id),
     },
     {
-      name: 'theme.stop_preview',
+      name: 'theme_stop_preview',
       description: 'Stop a running live preview session.',
       inputSchema: {
         theme_id: z.string().min(1),
@@ -166,7 +172,7 @@ export function createThemeToolCatalog() {
       execute: ({ theme_id, session_id }, client) => client.stopThemePreview(theme_id, session_id),
     },
     {
-      name: 'theme.publish',
+      name: 'theme_publish',
       description: 'Queue a publish/deploy for the current accepted theme draft.',
       inputSchema: {
         theme_id: z.string().min(1),
@@ -174,7 +180,7 @@ export function createThemeToolCatalog() {
       execute: ({ theme_id }, client) => client.publishTheme(theme_id),
     },
     {
-      name: 'theme.publish_status',
+      name: 'theme_publish_status',
       description: 'Read the current publish job status.',
       inputSchema: {
         theme_id: z.string().min(1),
@@ -183,7 +189,7 @@ export function createThemeToolCatalog() {
       execute: ({ theme_id, job_id }, client) => client.getThemePublishStatus(theme_id, job_id),
     },
     {
-      name: 'theme.validate',
+      name: 'theme_validate',
       description: 'Run a validation-only build and optional typecheck without publishing.',
       inputSchema: {
         theme_id: z.string().min(1),
@@ -194,7 +200,7 @@ export function createThemeToolCatalog() {
       }),
     },
     {
-      name: 'theme.settings_get',
+      name: 'theme_settings_get',
       description: 'Read the current builder settings values for a theme.',
       inputSchema: {
         theme_id: z.string().min(1),
@@ -202,7 +208,7 @@ export function createThemeToolCatalog() {
       execute: ({ theme_id }, client) => client.getThemeSettings(theme_id),
     },
     {
-      name: 'theme.settings_update',
+      name: 'theme_settings_update',
       description: 'Update theme builder settings without editing source files directly.',
       inputSchema: {
         theme_id: z.string().min(1),
@@ -213,7 +219,7 @@ export function createThemeToolCatalog() {
       }),
     },
     {
-      name: 'theme.backups',
+      name: 'theme_backups',
       description: 'List available theme backups for rollback.',
       inputSchema: {
         theme_id: z.string().min(1),
@@ -221,7 +227,7 @@ export function createThemeToolCatalog() {
       execute: ({ theme_id }, client) => client.listThemeBackups(theme_id),
     },
     {
-      name: 'theme.rollback',
+      name: 'theme_rollback',
       description: 'Rollback a theme to a previous backup snapshot.',
       inputSchema: {
         theme_id: z.string().min(1),
@@ -230,7 +236,7 @@ export function createThemeToolCatalog() {
       execute: ({ theme_id, backup_id }, client) => client.rollbackTheme(theme_id, backup_id),
     },
     {
-      name: 'theme.latest_run',
+      name: 'theme_latest_run',
       description: 'Read the latest dashboard-agent run metadata for a theme.',
       inputSchema: {
         theme_id: z.string().min(1),
@@ -240,8 +246,13 @@ export function createThemeToolCatalog() {
   ];
 }
 
+function normalizeToolName(name) {
+  return typeof name === 'string' ? name.replace(/\./g, '_') : name;
+}
+
 export async function executeThemeTool(toolName, args, client) {
-  const tool = createThemeToolCatalog().find((entry) => entry.name === toolName);
+  const normalized = normalizeToolName(toolName);
+  const tool = createThemeToolCatalog().find((entry) => entry.name === normalized);
   if (!tool) {
     throw new Error(`Unknown tool: ${toolName}`);
   }