@mentagen/mcp 0.8.4 → 0.8.6

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,5 +1,7 @@
 import { z } from 'zod';
+import { nodeColorSchema } from '../utils/colors.js';
 import { formatError } from '../utils/errors.js';
+import { normalizeTextEscapes } from '../utils/normalize.js';
 import { unitsToPixels } from '../utils/units.js';
 import { snapToGrid } from './grid-calc.js';
 import { validateTypeChange } from './update.js';
@@ -19,7 +21,7 @@ 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'),
+    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'),
@@ -82,7 +84,14 @@ function buildNodeUpdateData(data, migrationFields) {
             cleanData[key] = snapToGrid(unitsToPixels(value));
         }
         else if (key === 'todos') {
-            cleanData[key] = value;
+            const todos = value.map(t => ({
+                ...t,
+                text: normalizeTextEscapes(t.text),
+            }));
+            cleanData[key] = todos;
+        }
+        else if (key === 'content') {
+            cleanData[key] = normalizeTextEscapes(value);
         }
         else {
             cleanData[key] = value;

package/dist/tools/create-graph.js

@@ -1,5 +1,7 @@
 import { z } from 'zod';
+import { nodeColorSchema } from '../utils/colors.js';
 import { formatError } from '../utils/errors.js';
+import { normalizeTextEscapes } from '../utils/normalize.js';
 import { pixelsToUnits, unitsToPixels } from '../utils/units.js';
 import { applyExtension, generateId, normalizeTodos } from './create.js';
 import { snapToGrid } from './grid-calc.js';
@@ -25,7 +27,7 @@ const nodeInputSchema = z.object({
         .optional()
         .default('markdown')
         .describe('Node type'),
-    color: z.string().optional().describe('Node color'),
+    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'),
@@ -80,7 +82,8 @@ async function createNode(client, boardId, nodeInput, idMap) {
     const autoSize = calculateNodeSize(finalName, type);
     const dims = calcNodeDimensions(nodeInput, autoSize);
     const isCodeNode = type === 'code';
-    const nodeContent = nodeInput.content ?? '';
+    const rawContent = nodeInput.content ?? '';
+    const nodeContent = isCodeNode ? rawContent : normalizeTextEscapes(rawContent);
     // Only pass todos for non-code nodes
     const todos = !isCodeNode && nodeInput.todos ? normalizeTodos(nodeInput.todos) : undefined;
     try {

package/dist/tools/create.js

@@ -1,6 +1,8 @@
 import { randomUUID } from 'crypto';
 import { z } from 'zod';
+import { nodeColorSchema } from '../utils/colors.js';
 import { formatError } from '../utils/errors.js';
+import { normalizeTextEscapes } from '../utils/normalize.js';
 import { pixelsToUnits, unitsToPixels } from '../utils/units.js';
 import { getNodeUrl } from '../utils/urls.js';
 import { snapToGrid } from './grid-calc.js';
@@ -62,8 +64,7 @@ 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.coerce
@@ -113,7 +114,7 @@ export function generateId() {
 export function normalizeTodos(todos) {
     return todos.map((todo, index) => ({
         id: randomUUID(),
-        text: todo.text,
+        text: normalizeTextEscapes(todo.text),
         completed: todo.completed ?? false,
         order: index,
     }));
@@ -139,14 +140,14 @@ function buildNodeFields(params, color, position) {
         }
         nodeFields.url = params.url;
         if (params.content) {
-            nodeFields.content = params.content;
+            nodeFields.content = normalizeTextEscapes(params.content);
         }
         if (params.todos) {
             nodeFields.todos = normalizeTodos(params.todos);
         }
     }
     else {
-        nodeFields.content = params.content || '';
+        nodeFields.content = normalizeTextEscapes(params.content || '');
         if (params.todos) {
             nodeFields.todos = normalizeTodos(params.todos);
         }

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/patch-content.js

@@ -1,6 +1,7 @@
 import { z } from 'zod';
 import { NodeType } from '../client/types.js';
 import { formatError } from '../utils/errors.js';
+import { normalizeTextEscapes } from '../utils/normalize.js';
 const replaceOp = z.object({
     type: z.literal('replace'),
     oldString: z.string().min(1),
@@ -68,12 +69,20 @@ export async function handlePatchContent(client, params) {
             nodeId: params.nodeId,
         });
         const { field, text: initialText } = getNodeTextField(node);
+        const isCode = field === 'code';
         let text = initialText;
         const appliedOps = [];
+        /** Normalize escape sequences for non-code content fields. */
+        const normalize = (s) => isCode ? s : normalizeTextEscapes(s);
         for (const op of params.operations) {
             switch (op.type) {
                 case 'replace': {
-                    const { result, error } = applyReplace(text, op);
+                    const normalizedOp = {
+                        ...op,
+                        oldString: normalize(op.oldString),
+                        newString: normalize(op.newString),
+                    };
+                    const { result, error } = applyReplace(text, normalizedOp);
                     if (error) {
                         return {
                             content: [
@@ -95,14 +104,18 @@ export async function handlePatchContent(client, params) {
                     appliedOps.push(`replace: "${truncate(op.oldString, 30)}" → "${truncate(op.newString, 30)}"`);
                     break;
                 }
-                case 'prepend':
-                    text = op.content + text;
-                    appliedOps.push(`prepend: ${op.content.length} chars`);
+                case 'prepend': {
+                    const content = normalize(op.content);
+                    text = content + text;
+                    appliedOps.push(`prepend: ${content.length} chars`);
                     break;
-                case 'append':
-                    text = text + op.content;
-                    appliedOps.push(`append: ${op.content.length} chars`);
+                }
+                case 'append': {
+                    const content = normalize(op.content);
+                    text = text + content;
+                    appliedOps.push(`append: ${content.length} chars`);
                     break;
+                }
             }
         }
         await client.updateNode({

package/dist/tools/todo.js

@@ -1,6 +1,7 @@
 import { randomUUID } from 'crypto';
 import { z } from 'zod';
 import { formatError } from '../utils/errors.js';
+import { normalizeTextEscapes } from '../utils/normalize.js';
 // ─────────────────────────────────────────────────────────────────────────────
 // Schemas
 // ─────────────────────────────────────────────────────────────────────────────
@@ -36,7 +37,7 @@ export async function handleAddTodo(client, params) {
         const existingTodos = node.todos || [];
         const newTodo = {
             id: randomUUID(),
-            text: params.text,
+            text: normalizeTextEscapes(params.text),
             completed: false,
             order: existingTodos.length,
         };

package/dist/tools/update.js

@@ -1,6 +1,8 @@
 import { z } from 'zod';
 import { NodeType } from '../client/types.js';
+import { nodeColorSchema } from '../utils/colors.js';
 import { formatError } from '../utils/errors.js';
+import { normalizeTextEscapes } from '../utils/normalize.js';
 import { pixelsToUnits, unitsToPixels } from '../utils/units.js';
 import { snapToGrid } from './grid-calc.js';
 import { calculateNodeSize } from './size-calc.js';
@@ -40,8 +42,7 @@ 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.coerce.number().optional().describe('X position in grid units'),
@@ -132,11 +133,11 @@ function addContentFields(data, params, nodeType) {
             data.url = params.url;
         }
         if (params.content !== undefined) {
-            data.content = params.content;
+            data.content = normalizeTextEscapes(params.content);
         }
     }
     else if (params.content !== undefined) {
-        data.content = params.content;
+        data.content = normalizeTextEscapes(params.content);
     }
 }
 /**

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/dist/utils/normalize.js

@@ -0,0 +1,11 @@
+/**
+ * Normalize literal escape sequences commonly produced by LLMs in MCP tool parameters.
+ *
+ * LLMs often write `\n` as two literal characters (backslash + n) instead of
+ * an actual newline character. This converts those sequences for text content fields.
+ *
+ * Should NOT be applied to code fields where escape sequences are intentional.
+ */
+export function normalizeTextEscapes(text) {
+    return text.replaceAll('\\n', '\n').replaceAll('\\t', '\t');
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mentagen/mcp",
-  "version": "0.8.4",
+  "version": "0.8.6",
   "description": "MCP server for Mentagen knowledge base integration with Cursor",
   "type": "module",
   "bin": "dist/index.js",