openhive-mcp-server 1.3.0 → 1.5.0

package/index.js

@@ -53,7 +53,7 @@ async function apiRequest(path, options = {}) {
   return data.data;
 }
 
-const server = new McpServer({ name: 'openhive', version: '1.3.0' });
+const server = new McpServer({ name: 'openhive', version: '1.5.0' });
 
 // ── Posts ──
 
@@ -681,6 +681,87 @@ server.tool(
   }
 );
 
+// ── Design Systems (visual inspirations library) ──
+
+server.tool(
+  'list_design_systems',
+  'Lista a biblioteca de 58 design systems de marcas conhecidas (Stripe, Linear, Apple, Notion, etc) que podem ser usados como inspiracao visual para criar brands. Cada item retorna nome, vibe, categoria, paleta principal e mood keywords. Use isso quando o usuario pedir ajuda para criar um brand do zero ou refinar a identidade visual',
+  {
+    category: z.enum(['fintech', 'productivity', 'dev-tools', 'ai', 'luxury', 'automotive', 'social', 'media', 'other']).optional().describe('Filtrar por categoria'),
+    search: z.string().optional().describe('Buscar por nome, vibe ou mood keyword (ex: warm, dark, minimal)'),
+    limit: z.number().optional().describe('Quantidade maxima a retornar'),
+  },
+  async (input) => {
+    const params = new URLSearchParams();
+    if (input.category) params.set('category', input.category);
+    if (input.search) params.set('search', input.search);
+    if (input.limit) params.set('limit', String(input.limit));
+    const qs = params.toString();
+    const result = await apiRequest(`/api/design-systems${qs ? '?' + qs : ''}`);
+    return {
+      content: [{
+        type: 'text',
+        text: JSON.stringify({
+          total_in_library: result.totalAvailable,
+          returned: result.total,
+          design_systems: result.items.map((d) => ({
+            id: d.id,
+            name: d.name,
+            vibe: d.vibe,
+            category: d.category,
+            mood_keywords: d.moodKeywords,
+            primary_color: d.colors.primary,
+            secondary_color: d.colors.secondary,
+          })),
+        }, null, 2),
+      }],
+    };
+  }
+);
+
+server.tool(
+  'get_design_system',
+  'Retorna detalhes completos de um design system especifico (todas as cores, tipografia, principios). Use depois de list_design_systems quando o usuario escolher uma inspiracao',
+  {
+    design_system_id: z.string().describe('ID do design system (ex: stripe, linear, apple)'),
+  },
+  async (input) => {
+    const result = await apiRequest(`/api/design-systems/${input.design_system_id}`);
+    return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+  }
+);
+
+server.tool(
+  'list_design_system_categories',
+  'Retorna as categorias disponiveis na biblioteca de design systems com a quantidade em cada (fintech, dev-tools, ai, etc)',
+  {},
+  async () => {
+    const result = await apiRequest('/api/design-systems/categories');
+    return { content: [{ type: 'text', text: JSON.stringify({ categories: result }, null, 2) }] };
+  }
+);
+
+server.tool(
+  'suggest_brand_from_inspirations',
+  'Combina 1-5 design systems da biblioteca em uma sugestao de brand. Retorna paleta de cores, fonte, tom de voz e descricao. NAO salva nada - apenas sugere. Para salvar use create_brand depois que o usuario aprovar',
+  {
+    inspiration_ids: z.array(z.string()).min(1).max(5).describe('IDs dos design systems para combinar (ex: ["stripe", "linear"])'),
+    business_name: z.string().optional().describe('Nome do negocio do usuario'),
+    business_type: z.string().optional().describe('Tipo de negocio (ex: "AI startup", "fintech")'),
+  },
+  async (input) => {
+    const result = await apiRequest('/api/design-systems/suggest', {
+      method: 'POST',
+      body: JSON.stringify({
+        inspirationIds: input.inspiration_ids,
+        businessName: input.business_name,
+        businessType: input.business_type,
+      }),
+    });
+    return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+  }
+);
+
 // ── Brands ──
 
 server.tool('list_brands', 'Lista todos os brands cadastrados (identidade visual: logo, cores, produtos, tom de voz). Use ANTES de criar qualquer post visual para perguntar ao usuario qual brand aplicar', {}, async () => {
@@ -700,17 +781,22 @@ server.tool('get_default_brand', 'Retorna o brand padrao do usuario (se houver).
   return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
 });
 
-server.tool('create_brand', 'Cria um novo brand com identidade visual. Aceita website_url e instagram_url para que agentes possam pesquisar informacoes da marca', {
+server.tool('create_brand', 'Cria um novo brand com identidade visual completa: 6 cores (primary, secondary, accent, background, text, muted) + 3 fontes (display, heading, body). Aceita website_url e instagram_url para que agentes possam pesquisar referencias', {
   name: z.string().describe('Nome do brand'),
   logo_url: z.string().optional().describe('URL do logo'),
-  primary_color: z.string().optional().describe('Cor primaria em hex (#RRGGBB)'),
-  secondary_color: z.string().optional().describe('Cor secundaria em hex (#RRGGBB)'),
-  accent_color: z.string().optional().describe('Cor de destaque em hex'),
-  font_family: z.string().optional().describe('Familia de fonte preferida'),
+  primary_color: z.string().optional().describe('Cor primaria em hex (#RRGGBB) - cor principal da marca'),
+  secondary_color: z.string().optional().describe('Cor secundaria em hex - cor de apoio'),
+  accent_color: z.string().optional().describe('Cor de destaque em hex - usada em CTAs e highlights'),
+  background_color: z.string().optional().describe('Cor de fundo em hex - cor base dos slides'),
+  text_color: z.string().optional().describe('Cor de texto principal em hex'),
+  muted_color: z.string().optional().describe('Cor neutra/muted em hex - bordas, textos secundarios'),
+  font_family: z.string().optional().describe('Familia de fonte display/principal (ex: Inter Variable)'),
+  heading_font: z.string().optional().describe('Fonte para titulos (ex: Sora, Geist)'),
+  body_font: z.string().optional().describe('Fonte para textos longos/body (ex: Inter)'),
   description: z.string().optional().describe('Descricao do brand'),
   voice_tone: z.string().optional().describe('Tom de voz: profissional, descontraido, educativo'),
   website_url: z.string().optional().describe('URL do site oficial - agentes podem visitar para pesquisar informacoes e contexto'),
-  instagram_url: z.string().optional().describe('URL do perfil Instagram - agentes podem analisar o estilo visual e de conteudo para manter consistencia'),
+  instagram_url: z.string().optional().describe('URL do perfil Instagram - agentes podem analisar o estilo visual e de conteudo'),
   products: z.array(z.string()).optional().describe('Lista de produtos/servicos'),
   default_hashtags: z.array(z.string()).optional().describe('Hashtags padrao a aplicar nos posts'),
   is_default: z.boolean().optional().describe('Se este sera o brand padrao'),
@@ -721,7 +807,12 @@ server.tool('create_brand', 'Cria um novo brand com identidade visual. Aceita we
     primaryColor: input.primary_color,
     secondaryColor: input.secondary_color,
     accentColor: input.accent_color,
+    backgroundColor: input.background_color,
+    textColor: input.text_color,
+    mutedColor: input.muted_color,
     fontFamily: input.font_family,
+    headingFont: input.heading_font,
+    bodyFont: input.body_font,
     description: input.description,
     voiceTone: input.voice_tone,
     websiteUrl: input.website_url,
@@ -736,14 +827,19 @@ server.tool('create_brand', 'Cria um novo brand com identidade visual. Aceita we
   return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
 });
 
-server.tool('update_brand', 'Atualiza um brand existente', {
+server.tool('update_brand', 'Atualiza um brand existente. Todos os campos sao opcionais - so envie o que quer mudar', {
   brand_id: z.string().describe('ID do brand'),
   name: z.string().optional(),
   logo_url: z.string().optional(),
   primary_color: z.string().optional(),
   secondary_color: z.string().optional(),
   accent_color: z.string().optional(),
+  background_color: z.string().optional(),
+  text_color: z.string().optional(),
+  muted_color: z.string().optional(),
   font_family: z.string().optional(),
+  heading_font: z.string().optional(),
+  body_font: z.string().optional(),
   description: z.string().optional(),
   voice_tone: z.string().optional(),
   website_url: z.string().optional(),
@@ -758,7 +854,12 @@ server.tool('update_brand', 'Atualiza um brand existente', {
   if (input.primary_color !== undefined) body.primaryColor = input.primary_color;
   if (input.secondary_color !== undefined) body.secondaryColor = input.secondary_color;
   if (input.accent_color !== undefined) body.accentColor = input.accent_color;
+  if (input.background_color !== undefined) body.backgroundColor = input.background_color;
+  if (input.text_color !== undefined) body.textColor = input.text_color;
+  if (input.muted_color !== undefined) body.mutedColor = input.muted_color;
   if (input.font_family !== undefined) body.fontFamily = input.font_family;
+  if (input.heading_font !== undefined) body.headingFont = input.heading_font;
+  if (input.body_font !== undefined) body.bodyFont = input.body_font;
   if (input.description !== undefined) body.description = input.description;
   if (input.voice_tone !== undefined) body.voiceTone = input.voice_tone;
   if (input.website_url !== undefined) body.websiteUrl = input.website_url;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "openhive-mcp-server",
-  "version": "1.3.0",
-  "description": "OpenHive AI MCP Server - Connect Claude, Antigravity, Cursor and other IDEs to your OpenHive instance. 35 tools including Brands (with website_url + instagram_url for research) and Mixed Carousel.",
+  "version": "1.5.0",
+  "description": "OpenHive AI MCP Server - Connect Claude, Antigravity, Cursor and other IDEs to your OpenHive instance. 39 tools including Design Systems library (58 brand inspirations), Brands (6 colors + 3 fonts), Mixed Carousel.",
   "main": "index.js",
   "bin": {
     "openhive-mcp": "./index.js"