@meldocio/mcp-stdio-proxy 1.0.28 → 1.1.0

package/lib/mcp/tools-call.js

@@ -5,8 +5,7 @@
  * Local tools: set_workspace, get_workspace, auth_status, auth_login_instructions
  */
 
-const { sendResponse, sendError } = require('../protocol/json-rpc');
-const { JSON_RPC_ERROR_CODES } = require('../protocol/error-codes');
+const { sendResponse } = require('../protocol/json-rpc');
 const { getAuthStatus } = require('../core/auth');
 const { setWorkspaceAlias, getWorkspaceAlias } = require('../core/config');
 const { LOG_LEVELS } = require('../core/constants');
@@ -37,14 +36,16 @@ function log(level, message) {
  * @returns {Object} MCP result object
  */
 function createToolResponse(text) {
-  return {
-    content: [
-      {
-        type: 'text',
-        text: text
-      }
-    ]
-  };
+  return { content: [{ type: 'text', text }] };
+}
+
+/**
+ * Create MCP tool error response (isError: true per MCP spec)
+ * @param {string} message - Error message
+ * @returns {Object} MCP result object
+ */
+function createToolError(message) {
+  return { isError: true, content: [{ type: 'text', text: message }] };
 }
 
 /**
@@ -55,7 +56,7 @@ function createToolResponse(text) {
 function handleSetWorkspace(request, arguments_) {
   const alias = arguments_.alias;
   if (!alias || typeof alias !== 'string') {
-    sendError(request.id, JSON_RPC_ERROR_CODES.INVALID_PARAMS, 'alias parameter is required and must be a string');
+    sendResponse(request.id, createToolError('alias parameter is required and must be a string'));
     return;
   }
 
@@ -63,7 +64,7 @@ function handleSetWorkspace(request, arguments_) {
     setWorkspaceAlias(alias);
     sendResponse(request.id, createToolResponse(`Workspace alias set to: ${alias}`));
   } catch (error) {
-    sendError(request.id, JSON_RPC_ERROR_CODES.INTERNAL_ERROR, `Failed to set workspace alias: ${error.message}`);
+    sendResponse(request.id, createToolError(`Failed to set workspace alias: ${error.message}`));
   }
 }
 
@@ -81,7 +82,7 @@ function handleGetWorkspace(request) {
     };
     sendResponse(request.id, createToolResponse(JSON.stringify(result, null, 2)));
   } catch (error) {
-    sendError(request.id, JSON_RPC_ERROR_CODES.INTERNAL_ERROR, `Failed to get workspace: ${error.message}`);
+    sendResponse(request.id, createToolError(`Failed to get workspace: ${error.message}`));
   }
 }
 
@@ -103,7 +104,7 @@ async function handleAuthStatus(request) {
 
     sendResponse(request.id, createToolResponse(JSON.stringify(authStatus, null, 2)));
   } catch (error) {
-    sendError(request.id, JSON_RPC_ERROR_CODES.INTERNAL_ERROR, `Failed to get auth status: ${error.message}`);
+    sendResponse(request.id, createToolError(`Failed to get auth status: ${error.message}`));
   }
 }
 
@@ -165,10 +166,7 @@ async function handleToolsCall(request) {
     return true; // Handled
   } catch (error) {
     log(LOG_LEVELS.ERROR, `Unexpected error in handleToolsCall: ${error.message || 'Unknown error'}`);
-    sendError(request.id, JSON_RPC_ERROR_CODES.INTERNAL_ERROR,
-              `Error executing tool: ${error.message || 'Unknown error'}`, {
-                code: 'INTERNAL_ERROR'
-              });
+    sendResponse(request.id, createToolError(`Error executing tool: ${error.message || 'Unknown error'}`));
     return true; // Error handled
   }
 }

package/lib/protocol/tools-schema.js

@@ -1,179 +1,16 @@
 /**
  * MCP Tools Schema Definitions
  *
- * This module contains all tool definitions for the Meldoc MCP server.
- * Each tool has a name, description, and JSON Schema for input validation.
+ * Contains only the local tools handled by this proxy.
+ * All other tools are provided by the server-side MCP via tools/list forwarding.
  */
 
 /**
- * Get the complete list of MCP tools supported by this proxy
- * @returns {Array<Object>} Array of tool definitions with name, description, and inputSchema
+ * Local tools handled directly by this proxy (not forwarded to the server).
+ * @returns {Array<Object>} Array of local tool definitions
  */
-function getToolsList() {
+function getLocalToolsList() {
   return [
-    {
-      name: 'docs_list',
-      description: 'List documents in workspace/project. For public tokens, only shows published public documents.',
-      inputSchema: {
-        type: 'object',
-        properties: {
-          workspaceAlias: { type: 'string', description: 'Workspace alias (auto-selected if user has only one workspace)' },
-          workspaceId: { type: 'string', description: 'Workspace UUID (auto-selected if user has only one workspace)' },
-          projectId: { type: 'string', description: 'UUID of the project to list documents from' },
-          cursor: { type: 'string', description: 'Pagination cursor' },
-          limit: { type: 'integer', description: 'Maximum number of documents to return (default: 50, max: 100)' }
-        }
-      }
-    },
-    {
-      name: 'docs_get',
-      description: 'Get a specific document by ID or path. For public tokens, allows access to public and unlisted documents.',
-      inputSchema: {
-        type: 'object',
-        required: ['docId'],
-        properties: {
-          workspaceAlias: { type: 'string', description: 'Workspace alias (auto-selected if user has only one workspace)' },
-          workspaceId: { type: 'string', description: 'Workspace UUID (auto-selected if user has only one workspace)' },
-          docId: { type: 'string', description: 'UUID of the document (alias: id)' },
-          id: { type: 'string', description: 'UUID of the document (alias for docId)' },
-          path: { type: 'string', description: 'Path of the document (not yet implemented)' }
-        }
-      }
-    },
-    {
-      name: 'docs_tree',
-      description: 'Get the document tree structure for a project. For public tokens, only includes published public documents.',
-      inputSchema: {
-        type: 'object',
-        required: ['projectId'],
-        properties: {
-          workspaceAlias: { type: 'string', description: 'Workspace alias (auto-selected if user has only one workspace)' },
-          workspaceId: { type: 'string', description: 'Workspace UUID (auto-selected if user has only one workspace)' },
-          projectId: { type: 'string', description: 'UUID of the project' },
-          project_alias: { type: 'string', description: 'Alias of the project (alternative to projectId)' }
-        }
-      }
-    },
-    {
-      name: 'docs_search',
-      description: 'Search documents by text query. For public tokens, only searches published public documents.',
-      inputSchema: {
-        type: 'object',
-        required: ['query'],
-        properties: {
-          workspaceAlias: { type: 'string', description: 'Workspace alias (auto-selected if user has only one workspace)' },
-          workspaceId: { type: 'string', description: 'Workspace UUID (auto-selected if user has only one workspace)' },
-          query: { type: 'string', description: 'Search query text' },
-          projectId: { type: 'string', description: 'UUID of the project to search in' },
-          limit: { type: 'integer', description: 'Maximum number of results (default: 20, max: 50)' }
-        }
-      }
-    },
-    {
-      name: 'docs_update',
-      description: 'Update a document\'s content and/or metadata. Requires update permission (internal tokens only).',
-      inputSchema: {
-        type: 'object',
-        required: ['docId'],
-        properties: {
-          workspaceAlias: { type: 'string', description: 'Workspace alias (auto-selected if user has only one workspace)' },
-          workspaceId: { type: 'string', description: 'Workspace UUID (auto-selected if user has only one workspace)' },
-          docId: { type: 'string', description: 'UUID of the document to update' },
-          contentMd: { type: 'string', description: 'New markdown content for the document (optional, can update individual fields without content)' },
-          title: { type: 'string', description: 'New title for the document' },
-          alias: { type: 'string', description: 'New alias for the document' },
-          parentAlias: { type: 'string', description: 'Alias of the parent document (set to empty string to remove parent)' },
-          workflow: { type: 'string', enum: ['published', 'draft'], description: 'Workflow status: \'published\' or \'draft\'' },
-          visibility: { type: 'string', enum: ['visible', 'hidden'], description: 'Visibility: \'visible\' or \'hidden\'' },
-          exposure: { type: 'string', enum: ['private', 'unlisted', 'public', 'inherit'], description: 'Exposure level: \'private\', \'unlisted\', \'public\', or \'inherit\'' },
-          expectedUpdatedAt: { type: 'string', description: 'Expected updatedAt timestamp for optimistic locking (RFC3339 format)' }
-        }
-      }
-    },
-    {
-      name: 'docs_create',
-      description: 'Create a new document. Requires create permission (internal tokens only).',
-      inputSchema: {
-        type: 'object',
-        required: ['projectId', 'title', 'contentMd'],
-        properties: {
-          workspaceAlias: { type: 'string', description: 'Workspace alias (auto-selected if user has only one workspace)' },
-          workspaceId: { type: 'string', description: 'Workspace UUID (auto-selected if user has only one workspace)' },
-          projectId: { type: 'string', description: 'UUID of the project to create the document in' },
-          title: { type: 'string', description: 'Title of the document' },
-          contentMd: { type: 'string', description: 'Markdown content for the document' },
-          alias: { type: 'string', description: 'Alias for the document (will be auto-generated from title if not provided)' },
-          parentAlias: { type: 'string', description: 'Alias of the parent document' }
-        }
-      }
-    },
-    {
-      name: 'docs_delete',
-      description: 'Delete a document. Requires delete permission (internal tokens only).',
-      inputSchema: {
-        type: 'object',
-        required: ['docId'],
-        properties: {
-          workspaceAlias: { type: 'string', description: 'Workspace alias (auto-selected if user has only one workspace)' },
-          workspaceId: { type: 'string', description: 'Workspace UUID (auto-selected if user has only one workspace)' },
-          docId: { type: 'string', description: 'UUID of the document to delete' }
-        }
-      }
-    },
-    {
-      name: 'docs_links',
-      description: 'Get all outgoing links from a document (links that point from this document to other documents).',
-      inputSchema: {
-        type: 'object',
-        required: ['docId'],
-        properties: {
-          workspaceAlias: { type: 'string', description: 'Workspace alias (auto-selected if user has only one workspace)' },
-          workspaceId: { type: 'string', description: 'Workspace UUID (auto-selected if user has only one workspace)' },
-          docId: { type: 'string', description: 'UUID of the document' }
-        }
-      }
-    },
-    {
-      name: 'docs_backlinks',
-      description: 'Get all backlinks to a document (links from other documents that point to this document).',
-      inputSchema: {
-        type: 'object',
-        required: ['docId'],
-        properties: {
-          docId: { type: 'string', description: 'UUID of the document' }
-        }
-      }
-    },
-    {
-      name: 'projects_list',
-      description: 'List projects accessible by this token. For public tokens, only shows public projects.',
-      inputSchema: {
-        type: 'object',
-        properties: {
-          workspaceAlias: { type: 'string', description: 'Workspace alias (auto-selected if user has only one workspace)' },
-          workspaceId: { type: 'string', description: 'Workspace UUID (auto-selected if user has only one workspace)' }
-        }
-      }
-    },
-    {
-      name: 'server_info',
-      description: 'Get information about this MCP server\'s configuration, capabilities, and accessible projects.',
-      inputSchema: {
-        type: 'object',
-        properties: {
-          workspaceAlias: { type: 'string', description: 'Workspace alias (auto-selected if user has only one workspace)' },
-          workspaceId: { type: 'string', description: 'Workspace UUID (auto-selected if user has only one workspace)' }
-        }
-      }
-    },
-    {
-      name: 'list_workspaces',
-      description: 'List all workspaces accessible by the current user or integration token. For integration tokens, returns the workspace from token scope. Works without workspace header via /mcp/v1/rpc endpoint.',
-      inputSchema: {
-        type: 'object',
-        properties: {}
-      }
-    },
     {
       name: 'get_workspace',
       description: 'Get the current workspace alias from repo config or global config. Reads workspaceAlias from configuration files.',
@@ -212,6 +49,14 @@ function getToolsList() {
   ];
 }
 
+/**
+ * @deprecated Use getLocalToolsList() instead.
+ * Kept for backward compatibility with any code that imports getToolsList.
+ */
+function getToolsList() {
+  return getLocalToolsList();
+}
+
 /**
  * Check if a tool name exists in the schema
  * @param {string} toolName - The name of the tool to check
@@ -233,7 +78,8 @@ function getToolByName(toolName) {
 }
 
 module.exports = {
-  getToolsList,
+  getLocalToolsList,
+  getToolsList,       // backward compat alias for getLocalToolsList
   isValidToolName,
   getToolByName
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meldocio/mcp-stdio-proxy",
-  "version": "1.0.28",
+  "version": "1.1.0",
   "description": "MCP stdio proxy for meldoc - connects Claude Desktop and Claude Code to meldoc MCP API",
   "bin": {
     "meldoc-mcp": "bin/meldoc-mcp-proxy.js"