mcp-osp-prompt 1.0.0

package/utils.js

@@ -0,0 +1,145 @@
+/**
+ * Utility functions for MCP server to reduce code duplication
+ */
+
+/**
+ * Create a standard JSON-RPC success response
+ * @param {number|string} id - Request ID
+ * @param {any} result - Response result
+ * @returns {object} JSON-RPC response
+ */
+export function createSuccessResponse(id, result) {
+  return {
+    jsonrpc: '2.0',
+    id,
+    result
+  };
+}
+
+/**
+ * Create a standard JSON-RPC error response
+ * @param {number|string} id - Request ID
+ * @param {number} code - Error code
+ * @param {string} message - Error message
+ * @returns {object} JSON-RPC error response
+ */
+export function createErrorResponse(id, code, message) {
+  return {
+    jsonrpc: '2.0',
+    id,
+    error: { code, message }
+  };
+}
+
+/**
+ * Standard error codes for MCP
+ */
+export const MCP_ERROR_CODES = {
+  PARSE_ERROR: -32700,
+  INVALID_REQUEST: -32600,
+  METHOD_NOT_FOUND: -32601,
+  INVALID_PARAMS: -32602,
+  INTERNAL_ERROR: -32603
+};
+
+/**
+ * Check if a request is a notification (no response expected)
+ * @param {object} req - JSON-RPC request
+ * @returns {boolean} True if notification
+ */
+export function isNotification(req) {
+  return req.id === undefined || req.id === null;
+}
+
+/**
+ * Create standardized tool description for MCP tools list
+ * @param {string} name - Tool name
+ * @param {string} description - Tool description
+ * @param {object} inputSchema - JSON schema for input
+ * @returns {object} Tool description
+ */
+export function createToolDescription(name, description, inputSchema) {
+  return {
+    name,
+    description,
+    inputSchema
+  };
+}
+
+/**
+ * Create standardized prompt description for MCP prompts list
+ * @param {string} name - Prompt name
+ * @param {string} description - Prompt description
+ * @param {Array} arguments - Prompt arguments
+ * @returns {object} Prompt description
+ */
+export function createPromptDescription(name, description, arguments_) {
+  return {
+    name,
+    description,
+    arguments: arguments_
+  };
+}
+
+/**
+ * Validate JSON-RPC request structure
+ * @param {object} req - Request to validate
+ * @returns {object} Validation result
+ */
+export function validateRequest(req) {
+  const errors = [];
+  
+  if (!req || typeof req !== 'object') {
+    errors.push('Request must be an object');
+  }
+  
+  if (!req.jsonrpc || req.jsonrpc !== '2.0') {
+    errors.push('Invalid or missing jsonrpc version');
+  }
+  
+  if (!req.method || typeof req.method !== 'string') {
+    errors.push('Invalid or missing method');
+  }
+  
+  return {
+    isValid: errors.length === 0,
+    errors
+  };
+}
+
+/**
+ * Wrap async handler with error handling
+ * @param {Function} handler - Async handler function
+ * @returns {Function} Wrapped handler
+ */
+export function withErrorHandling(handler) {
+  return async (req) => {
+    try {
+      const validation = validateRequest(req);
+      if (!validation.isValid) {
+        return createErrorResponse(req.id, MCP_ERROR_CODES.INVALID_REQUEST, 
+          `Invalid request: ${validation.errors.join(', ')}`);
+      }
+      
+      return await handler(req);
+    } catch (error) {
+      console.error(`Handler error for ${req.method}:`, error);
+      return createErrorResponse(req.id, MCP_ERROR_CODES.INTERNAL_ERROR, error.message);
+    }
+  };
+}
+
+/**
+ * Standardized MCP server info
+ */
+export const SERVER_INFO = {
+  name: 'osp-prompt',
+  version: '1.0.0'
+};
+
+/**
+ * Standardized MCP capabilities
+ */
+export const SERVER_CAPABILITIES = {
+  tools: {}
+};