@mentagen/mcp 0.8.3 → 0.8.5

package/dist/resources/index.js

@@ -1,23 +1,30 @@
-const NODE_COLORS = [
-    { name: 'amber', rgb: 'rgb(253, 230, 138)' },
-    { name: 'blue', rgb: 'rgb(0, 120, 255)' },
-    { name: 'cyan', rgb: 'rgb(0, 231, 255)' },
-    { name: 'emerald', rgb: 'rgb(0, 230, 118)' },
-    { name: 'fuchsia', rgb: 'rgb(233, 30, 99)' },
-    { name: 'green', rgb: 'rgb(52, 211, 153)' },
-    { name: 'indigo', rgb: 'rgb(72, 77, 201)' },
-    { name: 'lime', rgb: 'rgb(209, 250, 229)' },
-    { name: 'orange', rgb: 'rgb(252, 165, 0)' },
-    { name: 'pink', rgb: 'rgb(244, 143, 177)' },
-    { name: 'purple', rgb: 'rgb(156, 39, 176)' },
-    { name: 'red', rgb: 'rgb(239, 68, 68)' },
-    { name: 'rose', rgb: 'rgb(255, 204, 203)' },
-    { name: 'sky', rgb: 'rgb(0, 184, 230)' },
-    { name: 'slate', rgb: 'rgb(107, 114, 128)' },
-    { name: 'teal', rgb: 'rgb(0, 210, 183)' },
-    { name: 'violet', rgb: 'rgb(123, 31, 162)' },
-    { name: 'yellow', rgb: 'rgb(255, 251, 235)' },
-];
+import { VALID_NODE_COLORS } from '../utils/colors.js';
+/** RGB values for node colors, keyed by color name. */
+const COLOR_RGB = {
+    amber: 'rgb(253, 230, 138)',
+    blue: 'rgb(0, 120, 255)',
+    cyan: 'rgb(0, 231, 255)',
+    emerald: 'rgb(0, 230, 118)',
+    fuchsia: 'rgb(233, 30, 99)',
+    green: 'rgb(52, 211, 153)',
+    indigo: 'rgb(72, 77, 201)',
+    lime: 'rgb(209, 250, 229)',
+    orange: 'rgb(252, 165, 0)',
+    pink: 'rgb(244, 143, 177)',
+    purple: 'rgb(156, 39, 176)',
+    red: 'rgb(239, 68, 68)',
+    rose: 'rgb(255, 204, 203)',
+    sky: 'rgb(0, 184, 230)',
+    slate: 'rgb(107, 114, 128)',
+    teal: 'rgb(0, 210, 183)',
+    violet: 'rgb(123, 31, 162)',
+    yellow: 'rgb(255, 251, 235)',
+};
+/** Derive from VALID_NODE_COLORS so the resource stays in sync. */
+const NODE_COLORS = VALID_NODE_COLORS.map(name => ({
+    name,
+    rgb: COLOR_RGB[name] ?? '',
+}));
 /**
  * Supported node types with their default colors.
  *

package/dist/tools/batch-update.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { nodeColorSchema } from '../utils/colors.js';
 import { formatError } from '../utils/errors.js';
 import { unitsToPixels } from '../utils/units.js';
 import { snapToGrid } from './grid-calc.js';
@@ -6,8 +7,8 @@ import { validateTypeChange } from './update.js';
 const todoItemSchema = z.object({
     id: z.string().describe('Unique identifier (UUID v4)'),
     text: z.string().describe('Todo text content'),
-    completed: z.boolean().describe('Completion status'),
-    order: z.number().describe('Sort order (0-based)'),
+    completed: z.coerce.boolean().describe('Completion status'),
+    order: z.coerce.number().describe('Sort order (0-based)'),
 });
 const nodeUpdateSchema = z.object({
     nodeId: z.string().describe('The node ID to update'),
@@ -19,11 +20,11 @@ const nodeUpdateSchema = z.object({
     content: z.string().optional().describe('New content for the node'),
     code: z.string().optional().describe('Code content for code-type nodes'),
     url: z.string().optional().describe('URL for url-type nodes'),
-    color: z.string().optional().describe('Node color'),
-    x: z.number().optional().describe('X position in grid units'),
-    y: z.number().optional().describe('Y position in grid units'),
-    width: z.number().optional().describe('Node width in grid units'),
-    height: z.number().optional().describe('Node height in grid units'),
+    color: nodeColorSchema.optional().describe('Node color'),
+    x: z.coerce.number().optional().describe('X position in grid units'),
+    y: z.coerce.number().optional().describe('Y position in grid units'),
+    width: z.coerce.number().optional().describe('Node width in grid units'),
+    height: z.coerce.number().optional().describe('Node height in grid units'),
     todos: z
         .array(todoItemSchema)
         .optional()

package/dist/tools/check-collision.js

@@ -4,10 +4,10 @@ import { formatError } from '../utils/errors.js';
 import { pixelsToUnits, unitsToPixels } from '../utils/units.js';
 export const checkCollisionSchema = z.object({
     boardId: z.string().describe('The board ID to check against'),
-    x: z.number().describe('Left position of the rectangle in grid units'),
-    y: z.number().describe('Top position of the rectangle in grid units'),
-    width: z.number().describe('Width of the rectangle in grid units'),
-    height: z.number().describe('Height of the rectangle in grid units'),
+    x: z.coerce.number().describe('Left position of the rectangle in grid units'),
+    y: z.coerce.number().describe('Top position of the rectangle in grid units'),
+    width: z.coerce.number().describe('Width of the rectangle in grid units'),
+    height: z.coerce.number().describe('Height of the rectangle in grid units'),
     excludeNodeId: z
         .string()
         .optional()

package/dist/tools/create-graph.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { nodeColorSchema } from '../utils/colors.js';
 import { formatError } from '../utils/errors.js';
 import { pixelsToUnits, unitsToPixels } from '../utils/units.js';
 import { applyExtension, generateId, normalizeTodos } from './create.js';
@@ -6,7 +7,7 @@ import { snapToGrid } from './grid-calc.js';
 import { calculateNodeSize } from './size-calc.js';
 const todoInputSchema = z.object({
     text: z.string().describe('Todo text content'),
-    completed: z
+    completed: z.coerce
         .boolean()
         .optional()
         .default(false)
@@ -25,11 +26,11 @@ const nodeInputSchema = z.object({
         .optional()
         .default('markdown')
         .describe('Node type'),
-    color: z.string().optional().describe('Node color'),
-    x: z.number().optional().describe('X position in grid units'),
-    y: z.number().optional().describe('Y position in grid units'),
-    width: z.number().optional().describe('Width in grid units'),
-    height: z.number().optional().describe('Height in grid units'),
+    color: nodeColorSchema.optional().describe('Node color'),
+    x: z.coerce.number().optional().describe('X position in grid units'),
+    y: z.coerce.number().optional().describe('Y position in grid units'),
+    width: z.coerce.number().optional().describe('Width in grid units'),
+    height: z.coerce.number().optional().describe('Height in grid units'),
     todos: z
         .array(todoInputSchema)
         .optional()

package/dist/tools/create.js

@@ -1,5 +1,6 @@
 import { randomUUID } from 'crypto';
 import { z } from 'zod';
+import { nodeColorSchema } from '../utils/colors.js';
 import { formatError } from '../utils/errors.js';
 import { pixelsToUnits, unitsToPixels } from '../utils/units.js';
 import { getNodeUrl } from '../utils/urls.js';
@@ -62,24 +63,29 @@ export const createSchema = z.object({
         .optional()
         .default('markdown')
         .describe('Node type: markdown (default), code, or url'),
-    color: z
-        .string()
+    color: nodeColorSchema
         .optional()
         .describe('Optional color override. If not specified, uses default for type (markdown=cyan, code=indigo, url=blue)'),
-    x: z.number().optional().describe('X position in grid units (default: 6)'),
-    y: z.number().optional().describe('Y position in grid units (default: 6)'),
-    width: z
+    x: z.coerce
+        .number()
+        .optional()
+        .describe('X position in grid units (default: 6)'),
+    y: z.coerce
+        .number()
+        .optional()
+        .describe('Y position in grid units (default: 6)'),
+    width: z.coerce
         .number()
         .optional()
         .describe('Width in grid units (default: auto-calculated)'),
-    height: z
+    height: z.coerce
         .number()
         .optional()
         .describe('Height in grid units (default: auto-calculated)'),
     todos: z
         .array(z.object({
         text: z.string().describe('Todo text content'),
-        completed: z
+        completed: z.coerce
             .boolean()
             .optional()
             .default(false)

package/dist/tools/extract-board-content.js

@@ -4,7 +4,7 @@ import { formatError } from '../utils/errors.js';
 import { getNodeUrl } from '../utils/urls.js';
 export const extractBoardContentSchema = z.object({
     boardId: z.string().describe('The board ID to extract content from'),
-    includeEmpty: z
+    includeEmpty: z.coerce
         .boolean()
         .default(false)
         .describe('Include nodes with no content (default: false)'),

package/dist/tools/find-position.js

@@ -4,8 +4,10 @@ import { formatError } from '../utils/errors.js';
 import { pixelsToUnits, unitsToPixels } from '../utils/units.js';
 export const findPositionSchema = z.object({
     boardId: z.string().describe('The board ID to search'),
-    width: z.number().describe('Width of the node to place in grid units'),
-    height: z.number().describe('Height of the node to place in grid units'),
+    width: z.coerce.number().describe('Width of the node to place in grid units'),
+    height: z.coerce
+        .number()
+        .describe('Height of the node to place in grid units'),
     anchorNodeId: z
         .string()
         .optional()
@@ -14,15 +16,15 @@ export const findPositionSchema = z.object({
         .enum(['right', 'below', 'left', 'above'])
         .optional()
         .describe('Search direction from anchor or start (default: right)'),
-    gap: z
+    gap: z.coerce
         .number()
         .optional()
         .describe('Gap between nodes in grid units. Use 6+ for connected nodes, 1 for unrelated (default: 1)'),
-    startX: z
+    startX: z.coerce
         .number()
         .optional()
         .describe('Explicit start X in grid units (ignored if anchorNodeId provided)'),
-    startY: z
+    startY: z.coerce
         .number()
         .optional()
         .describe('Explicit start Y in grid units (ignored if anchorNodeId provided)'),

package/dist/tools/grid-calc.js

@@ -7,23 +7,23 @@ export const gridCalcSchema = z
     operation: z
         .enum(['snap', 'next_x', 'next_y', 'grid_units'])
         .describe('The calculation operation to perform'),
-    value: z
+    value: z.coerce
         .number()
         .optional()
         .describe('Value to snap to the grid in units (for snap operation)'),
-    position: z
+    position: z.coerce
         .number()
         .optional()
         .describe('Current x or y position in units (for next_x/next_y operations)'),
-    size: z
+    size: z.coerce
         .number()
         .optional()
         .describe('Width or height of the current node in units (for next_x/next_y)'),
-    gap: z
+    gap: z.coerce
         .number()
         .optional()
         .describe('Gap between nodes in grid units. Use 6+ for connected nodes, 1 for unrelated (default: 1)'),
-    units: z
+    units: z.coerce
         .number()
         .optional()
         .describe('Number of grid units (for grid_units operation - deprecated, returns same value)'),
@@ -32,19 +32,19 @@ export const gridCalcSchema = z
         .string()
         .optional()
         .describe('Board ID - if provided, checks for collisions'),
-    nodeWidth: z
+    nodeWidth: z.coerce
         .number()
         .optional()
         .describe('Width of node being placed in grid units (required with boardId)'),
-    nodeHeight: z
+    nodeHeight: z.coerce
         .number()
         .optional()
         .describe('Height of node being placed in grid units (required with boardId)'),
-    nodeY: z
+    nodeY: z.coerce
         .number()
         .optional()
         .describe('Y position of node in grid units (required for next_x collision check)'),
-    nodeX: z
+    nodeX: z.coerce
         .number()
         .optional()
         .describe('X position of node in grid units (required for next_y collision check)'),

package/dist/tools/index.js

@@ -2,6 +2,7 @@
 // Using raw objects like { method: 'tools/list' } causes "Schema is missing
 // a method literal" errors because the SDK validates against ZodLiteral types.
 import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { VALID_NODE_COLORS } from '../utils/colors.js';
 import { batchUpdateSchema, handleBatchUpdate } from './batch-update.js';
 import { boardsSchema, handleBoards } from './boards.js';
 import { checkCollisionSchema, handleCheckCollision, } from './check-collision.js';
@@ -279,6 +280,7 @@ export function registerTools(server, client, config) {
                         },
                         color: {
                             type: 'string',
+                            enum: [...VALID_NODE_COLORS],
                             description: 'Optional color override. If not specified, uses default for type (markdown=cyan, code=indigo)',
                         },
                         x: {
@@ -344,6 +346,7 @@ export function registerTools(server, client, config) {
                         },
                         color: {
                             type: 'string',
+                            enum: [...VALID_NODE_COLORS],
                             description: 'Node color name (see mentagen://colors resource for available colors)',
                         },
                         x: {
@@ -407,7 +410,11 @@ export function registerTools(server, client, config) {
                                     nodeId: { type: 'string', description: 'The node ID' },
                                     name: { type: 'string', description: 'New name' },
                                     content: { type: 'string', description: 'New content' },
-                                    color: { type: 'string', description: 'Node color' },
+                                    color: {
+                                        type: 'string',
+                                        enum: [...VALID_NODE_COLORS],
+                                        description: 'Node color',
+                                    },
                                     x: {
                                         type: 'number',
                                         description: 'X position in grid units (1 unit = 16px)',
@@ -559,7 +566,11 @@ export function registerTools(server, client, config) {
                                         enum: ['text', 'markdown', 'code', 'url'],
                                         description: 'Node type (default: text).',
                                     },
-                                    color: { type: 'string', description: 'Node color' },
+                                    color: {
+                                        type: 'string',
+                                        enum: [...VALID_NODE_COLORS],
+                                        description: 'Node color',
+                                    },
                                     x: {
                                         type: 'number',
                                         description: 'X position in grid units (1 unit = 16px)',

package/dist/tools/list-edges.js

@@ -3,7 +3,7 @@ import { EdgeDirection } from '../client/types.js';
 import { formatError } from '../utils/errors.js';
 export const listEdgesSchema = z.object({
     boardId: z.string().describe('The board ID to list edges from'),
-    limit: z
+    limit: z.coerce
         .number()
         .max(1000)
         .optional()

package/dist/tools/list-nodes.js

@@ -6,7 +6,7 @@ import { pixelsToUnits } from '../utils/units.js';
 import { getNodeUrl } from '../utils/urls.js';
 export const listNodesSchema = z.object({
     boardId: z.string().describe('The board ID to list nodes from'),
-    limit: z
+    limit: z.coerce
         .number()
         .max(1000)
         .default(1000)

package/dist/tools/list-positions.js

@@ -4,7 +4,7 @@ import { formatError } from '../utils/errors.js';
 import { pixelsToUnits } from '../utils/units.js';
 export const listPositionsSchema = z.object({
     boardId: z.string().describe('The board ID to list node positions from'),
-    limit: z
+    limit: z.coerce
         .number()
         .max(1000)
         .default(1000)

package/dist/tools/patch-content.js

@@ -5,7 +5,7 @@ const replaceOp = z.object({
     type: z.literal('replace'),
     oldString: z.string().min(1),
     newString: z.string(),
-    replaceAll: z.boolean().optional(),
+    replaceAll: z.coerce.boolean().optional(),
 });
 const prependOp = z.object({
     type: z.literal('prepend'),

package/dist/tools/search.js

@@ -15,11 +15,11 @@ export const searchSchema = z.object({
         .string()
         .optional()
         .describe('Optional organization ID to limit search to boards in that organization'),
-    limit: z
+    limit: z.coerce
         .number()
         .default(10)
         .describe('Maximum number of results (default: 10)'),
-    semanticRatio: z
+    semanticRatio: z.coerce
         .number()
         .default(0.5)
         .describe('Balance between semantic (1.0) and keyword (0.0) search'),

package/dist/tools/size-calc.js

@@ -20,7 +20,6 @@ const AVG_CHAR_WIDTH = 8.5;
 const NODE_TYPES_WITH_ICONS = new Set([
     'ai-chat',
     'board',
-    'contact',
     'pdf',
     'file',
     'mermaid',

package/dist/tools/todo.js

@@ -13,7 +13,7 @@ export const toggleTodoSchema = z.object({
     boardId: z.string().describe('The board ID containing the node'),
     nodeId: z.string().describe('The node ID containing the todo'),
     todoId: z.string().describe('The todo ID to toggle'),
-    completed: z
+    completed: z.coerce
         .boolean()
         .optional()
         .describe('Set explicit completion state. Omit to toggle current state.'),

package/dist/tools/update.js

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import { NodeType } from '../client/types.js';
+import { nodeColorSchema } from '../utils/colors.js';
 import { formatError } from '../utils/errors.js';
 import { pixelsToUnits, unitsToPixels } from '../utils/units.js';
 import { snapToGrid } from './grid-calc.js';
@@ -40,15 +41,14 @@ export const updateSchema = z.object({
         .string()
         .optional()
         .describe('The URL for url-type nodes (e.g., https://example.com). Only for type="url".'),
-    color: z
-        .string()
+    color: nodeColorSchema
         .optional()
         .describe('Node color name (use mentagen_colors to see available colors)'),
-    x: z.number().optional().describe('X position in grid units'),
-    y: z.number().optional().describe('Y position in grid units'),
-    width: z.number().optional().describe('Node width in grid units'),
-    height: z.number().optional().describe('Node height in grid units'),
-    autoSize: z
+    x: z.coerce.number().optional().describe('X position in grid units'),
+    y: z.coerce.number().optional().describe('Y position in grid units'),
+    width: z.coerce.number().optional().describe('Node width in grid units'),
+    height: z.coerce.number().optional().describe('Node height in grid units'),
+    autoSize: z.coerce
         .boolean()
         .optional()
         .default(true)
@@ -57,8 +57,8 @@ export const updateSchema = z.object({
         .array(z.object({
         id: z.string().describe('Unique identifier (UUID v4)'),
         text: z.string().describe('Todo text content'),
-        completed: z.boolean().describe('Completion status'),
-        order: z.number().describe('Sort order (0-based)'),
+        completed: z.coerce.boolean().describe('Completion status'),
+        order: z.coerce.number().describe('Sort order (0-based)'),
     }))
         .optional()
         .describe('Replace all todos on this markdown node. Only markdown/text nodes support todos; code nodes do not. Each todo needs id, text, completed, and order fields.'),

package/dist/utils/colors.js

@@ -0,0 +1,27 @@
+import { z } from 'zod';
+/**
+ * Valid node color names matching the Mongoose schema enum (BaseColor).
+ * Keep in sync with: src/common/constants/color.ts
+ */
+export const VALID_NODE_COLORS = [
+    'amber',
+    'blue',
+    'cyan',
+    'emerald',
+    'fuchsia',
+    'green',
+    'indigo',
+    'lime',
+    'orange',
+    'pink',
+    'purple',
+    'red',
+    'rose',
+    'sky',
+    'slate',
+    'teal',
+    'violet',
+    'yellow',
+];
+/** Zod schema for validating node colors against the Mongoose enum. */
+export const nodeColorSchema = z.enum(VALID_NODE_COLORS);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mentagen/mcp",
-  "version": "0.8.3",
+  "version": "0.8.5",
   "description": "MCP server for Mentagen knowledge base integration with Cursor",
   "type": "module",
   "bin": "dist/index.js",
@@ -28,7 +28,7 @@
   ],
   "license": "UNLICENSED",
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.0.0",
+    "@modelcontextprotocol/sdk": "1.26.0",
     "@resvg/resvg-js": "^2.6.2",
     "ejson2": "^1.1.0",
     "papaparse": "^5.5.3",
@@ -45,6 +45,8 @@
     "node": ">=18"
   },
   "resolutions": {
+    "@isaacs/brace-expansion": "^5.0.1",
+    "minimatch": "^10.1.2",
     "tar": "^7.5.7"
   }
 }