@mentagen/mcp 0.6.0 → 0.7.0

package/dist/index.js

@@ -2,6 +2,7 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { createMentagenClient } from './client/helene.js';
+import { registerResources } from './resources/index.js';
 import { registerTools } from './tools/index.js';
 import { loadConfig } from './utils/config.js';
 async function main() {
@@ -13,8 +14,10 @@ async function main() {
     }, {
         capabilities: {
             tools: {},
+            resources: {},
         },
     });
+    registerResources(mcpServer);
     registerTools(mcpServer.server, client, config);
     const transport = new StdioServerTransport();
     await mcpServer.connect(transport);

package/dist/resources/index.js

@@ -0,0 +1,93 @@
+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)' },
+];
+/**
+ * Supported node types with their default colors.
+ *
+ * Keep in sync with: src/client/features/boards/inner-board-context-menu.tsx
+ */
+const NODE_TYPES = [
+    {
+        type: 'text',
+        defaultColor: null,
+        description: 'Simple text node with a title and optional rich text content.',
+        usage: 'Use for short notes, labels, headings, or any content that needs a title.',
+        fields: {
+            name: 'The node title (required)',
+            content: 'Optional HTML content',
+        },
+    },
+    {
+        type: 'markdown',
+        defaultColor: 'cyan',
+        description: 'Markdown node for longer-form content with full Markdown syntax support.',
+        usage: 'Use for documentation, articles, formatted notes, or any content that benefits from Markdown formatting.',
+        fields: {
+            name: 'The node title (required)',
+            content: 'Markdown content (supports full GFM syntax)',
+        },
+    },
+    {
+        type: 'code',
+        defaultColor: 'indigo',
+        description: 'Code node for storing and displaying source code with syntax highlighting.',
+        usage: 'Use for code snippets, scripts, configuration files. Supports multiple programming languages.',
+        fields: {
+            name: 'The node title (required)',
+            content: 'Source code content',
+        },
+    },
+    {
+        type: 'url',
+        defaultColor: 'blue',
+        description: 'Bookmark node that stores and displays a link to an external URL.',
+        usage: 'Use for saving references to external resources, articles, documentation, or any web link.',
+        fields: {
+            name: 'The link title (required)',
+            url: 'The full URL including protocol (e.g., https://example.com)',
+        },
+    },
+];
+export function registerResources(mcpServer) {
+    mcpServer.resource('Node Colors', 'mentagen://colors', {
+        description: 'Available colors for nodes. Use the color name when creating or updating nodes.',
+        mimeType: 'application/json',
+    }, async () => ({
+        contents: [
+            {
+                uri: 'mentagen://colors',
+                mimeType: 'application/json',
+                text: JSON.stringify({ colors: NODE_COLORS }, null, 2),
+            },
+        ],
+    }));
+    mcpServer.resource('Node Types', 'mentagen://node-types', {
+        description: 'Supported node types with descriptions and usage guidance. Specify the type parameter when creating nodes.',
+        mimeType: 'application/json',
+    }, async () => ({
+        contents: [
+            {
+                uri: 'mentagen://node-types',
+                mimeType: 'application/json',
+                text: JSON.stringify({ nodeTypes: NODE_TYPES }, null, 2),
+            },
+        ],
+    }));
+}

package/dist/tools/index.js

@@ -5,7 +5,6 @@ import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextpro
 import { batchUpdateSchema, handleBatchUpdate } from './batch-update.js';
 import { boardsSchema, handleBoards } from './boards.js';
 import { checkCollisionSchema, handleCheckCollision, } from './check-collision.js';
-import { colorsSchema, handleColors } from './colors.js';
 import { createSchema, handleCreate } from './create.js';
 import { createBoardSchema, handleCreateBoard } from './create-board.js';
 import { createEdgeSchema, handleCreateEdge } from './create-edge.js';
@@ -22,11 +21,9 @@ import { handleListNodes, listNodesSchema } from './list-nodes.js';
 import { handleListOrganizations, listOrganizationsSchema, } from './list-organizations.js';
 import { handleListPositions, listPositionsSchema } from './list-positions.js';
 import { handleListTeams, listTeamsSchema } from './list-teams.js';
-import { handleNodeTypes, nodeTypesSchema } from './node-types.js';
 import { handlePatchContent, patchContentSchema } from './patch-content.js';
 import { handleRead, readSchema } from './read.js';
 import { handleSearch, searchSchema } from './search.js';
-import { handleSearchBoard, searchBoardSchema } from './search-board.js';
 import { handleSearchBoards, searchBoardsSchema } from './search-boards.js';
 import { handleSizeCalc, sizeCalcSchema } from './size-calc.js';
 import { handleUpdate, updateSchema } from './update.js';
@@ -204,7 +201,7 @@ export function registerTools(server, client, config) {
             },
             {
                 name: 'mentagen_search_nodes',
-                description: 'Search for nodes across ALL your boards using semantic search. Returns matching nodes with truncated content previews and direct links. Use mentagen_search_board to search within a specific board, or mentagen_read_node with the node ID to retrieve full content.',
+                description: 'Search for nodes using semantic search. Returns matching nodes with truncated content previews and direct links. Use mentagen_read_node with the node ID to retrieve full content.',
                 inputSchema: {
                     type: 'object',
                     properties: {
@@ -234,34 +231,6 @@ export function registerTools(server, client, config) {
                     required: ['query'],
                 },
             },
-            {
-                name: 'mentagen_search_board',
-                description: 'Search for nodes within a SPECIFIC board using semantic search. Use this when you know which board to search in. Returns matching nodes with truncated content previews and direct links. Use mentagen_read_node with the node ID to retrieve full content.',
-                inputSchema: {
-                    type: 'object',
-                    properties: {
-                        boardId: {
-                            type: 'string',
-                            description: 'The board ID to search within (required)',
-                        },
-                        query: {
-                            type: 'string',
-                            description: 'The search query - can be a question or keywords',
-                        },
-                        limit: {
-                            type: 'number',
-                            description: 'Maximum number of results (default: 10)',
-                            default: 10,
-                        },
-                        semanticRatio: {
-                            type: 'number',
-                            description: 'Balance between semantic (1.0) and keyword (0.0) search',
-                            default: 0.5,
-                        },
-                    },
-                    required: ['boardId', 'query'],
-                },
-            },
             {
                 name: 'mentagen_read_node',
                 description: 'Read a single node by ID. Returns the full node content without truncation, unlike search results. Includes a direct link to the node.',
@@ -359,7 +328,7 @@ export function registerTools(server, client, config) {
                         },
                         color: {
                             type: 'string',
-                            description: 'Node color name (use mentagen_colors to see available colors)',
+                            description: 'Node color name (see mentagen://colors resource for available colors)',
                         },
                         x: {
                             type: 'number',
@@ -733,22 +702,6 @@ export function registerTools(server, client, config) {
                     required: ['boardId'],
                 },
             },
-            {
-                name: 'mentagen_colors',
-                description: 'Get the list of available colors for nodes. Returns color names and their RGB values.',
-                inputSchema: {
-                    type: 'object',
-                    properties: {},
-                },
-            },
-            {
-                name: 'mentagen_node_types',
-                description: 'Get the list of supported node types with descriptions and usage guidance. Use this to understand what types of nodes can be created.',
-                inputSchema: {
-                    type: 'object',
-                    properties: {},
-                },
-            },
             {
                 name: 'mentagen_grid_calc',
                 description: 'Math helper for calculating node positions in grid units (1 unit = 16px). Use gap=6+ for connected nodes, gap=1 for unrelated nodes. Operations: "snap" rounds to nearest integer unit, "next_x"/"next_y" calculate position after a node, "grid_units" is deprecated (returns same value).',
@@ -984,10 +937,6 @@ export function registerTools(server, client, config) {
             const params = searchSchema.parse(args);
             return handleSearch(client, params, config.mentagenUrl);
         },
-        mentagen_search_board: async (args) => {
-            const params = searchBoardSchema.parse(args);
-            return handleSearchBoard(client, params, config.mentagenUrl);
-        },
         mentagen_read_node: async (args) => {
             const params = readSchema.parse(args);
             return handleRead(client, params, config.mentagenUrl);
@@ -1038,14 +987,6 @@ export function registerTools(server, client, config) {
             const params = linkSchema.parse(args);
             return handleLink(params, config);
         },
-        mentagen_colors: async (args) => {
-            colorsSchema.parse(args);
-            return handleColors();
-        },
-        mentagen_node_types: async (args) => {
-            nodeTypesSchema.parse(args);
-            return handleNodeTypes();
-        },
         mentagen_grid_calc: async (args) => {
             const params = gridCalcSchema.parse(args);
             return handleGridCalc(params, client);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mentagen/mcp",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "MCP server for Mentagen knowledge base integration with Cursor",
   "type": "module",
   "bin": "dist/index.js",
@@ -45,6 +45,6 @@
     "node": ">=18"
   },
   "resolutions": {
-    "tar": "7.5.3"
+    "tar": "^7.5.4"
   }
 }