@meldocio/mcp-stdio-proxy 1.0.2 → 1.0.4

package/README.md

@@ -107,9 +107,11 @@ echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | \
 - ✅ JSON-RPC 2.0 protocol
 - ✅ Single and batch requests
 - ✅ Proper error handling with JSON-RPC error codes
-- ✅ Request timeout handling (30 seconds)
+- ✅ Request timeout handling (25 seconds)
 - ✅ Network error recovery
 - ✅ Line-by-line processing for streaming
+- ✅ Automatic support for all MCP tools (including `server_info`)
+- ✅ Metadata (`_meta`) in responses for better context
 
 ## JSON-RPC Error Codes
 
@@ -122,6 +124,49 @@ The proxy uses standard JSON-RPC 2.0 error codes:
 - `-32603`: Internal error (network errors, timeouts, etc.)
 - `-32000`: Server error (HTTP 4xx/5xx responses)
 
+## Available Tools
+
+The proxy automatically supports all tools provided by the meldoc MCP API, including:
+
+- **`server_info`** - Get information about the server configuration, available projects, and token capabilities
+- **`docs_list`** - List available documentation
+- **`docs_get`** - Get specific documentation content
+- And other tools as provided by the API
+
+### Example: Using `server_info`
+
+You can get server information using the `server_info` tool:
+
+```bash
+echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"server_info","arguments":{}}}' | \
+  MELDOC_MCP_TOKEN=your_token_here npx @meldocio/mcp-stdio-proxy
+```
+
+The response includes:
+- Server name (from token)
+- Token description (if provided)
+- Available projects with IDs, names, and aliases
+- Token capabilities (read, update, create, delete)
+- Usage hints
+
+### Response Metadata
+
+All tool responses now include a `_meta` field with contextual information:
+
+```json
+{
+  "items": [...],
+  "_meta": {
+    "server": "My Token",
+    "projects": ["Frontend Docs", "Backend API"],
+    "capabilities": ["read"],
+    "hint": "Read permission required for this operation"
+  }
+}
+```
+
+This metadata helps AI assistants understand the context and limitations of the current token.
+
 ## Troubleshooting
 
 ### Error: MELDOC_MCP_TOKEN environment variable is required

package/bin/meldoc-mcp-proxy.js

@@ -18,7 +18,7 @@ const JSON_RPC_ERROR_CODES = {
 const token = process.env.MELDOC_MCP_TOKEN;
 const apiUrl = process.env.MELDOC_API_URL || 'https://api.meldoc.io';
 const rpcEndpoint = `${apiUrl}/mcp/v1/rpc`;
-const REQUEST_TIMEOUT = 30000; // 30 seconds
+const REQUEST_TIMEOUT = 25000; // 25 seconds (less than Claude Desktop's 30s timeout)
 
 // Validate token
 if (!token) {
@@ -86,8 +86,11 @@ function handleLine(line) {
     const request = JSON.parse(line);
     handleRequest(request);
   } catch (parseError) {
-    // Invalid JSON - send parse error
-    sendError(null, JSON_RPC_ERROR_CODES.PARSE_ERROR, `Parse error: ${parseError.message}`);
+    // Invalid JSON - try to extract id from the raw line if possible
+    // For parse errors, we can't reliably get the id, so we skip the response
+    // to avoid Zod validation errors in Claude Desktop (it doesn't accept id: null)
+    // This is acceptable per JSON-RPC spec - parse errors can be ignored if id is unknown
+    console.error(`Parse error: ${parseError.message}`, { to: 'stderr' });
   }
 }
 
@@ -131,11 +134,16 @@ async function handleRequest(request) {
         const method = req.method;
         if (method === 'initialize') {
           handleInitialize(req);
-        } else if (method === 'initialized') {
+        } else if (method === 'initialized' || method === 'notifications/initialized') {
+          // Notification - no response needed
+          continue;
+        } else if (method === 'notifications/cancelled') {
           // Notification - no response needed
           continue;
         } else if (method === 'ping') {
           handlePing(req);
+        } else if (method === 'resources/list') {
+          handleResourcesList(req);
         } else {
           // Forward to backend
           await processSingleRequest(req);
@@ -157,15 +165,22 @@ async function handleRequest(request) {
   if (method === 'initialize') {
     handleInitialize(request);
     return;
-  } else if (method === 'initialized') {
+  } else if (method === 'initialized' || method === 'notifications/initialized') {
     // Notification - no response needed per MCP spec
     return;
+  } else if (method === 'notifications/cancelled') {
+    // Notification - no response needed
+    return;
   } else if (method === 'ping') {
     handlePing(request);
     return;
+  } else if (method === 'resources/list') {
+    // Return empty resources list (resources not supported yet)
+    handleResourcesList(request);
+    return;
   }
   
-  // All other methods (tools/*, resources/*, etc.) are forwarded to backend
+  // All other methods (tools/*, etc.) are forwarded to backend
   await processSingleRequest(request);
 }
 
@@ -185,7 +200,7 @@ function handleInitialize(request) {
       },
       serverInfo: {
         name: '@meldocio/mcp-stdio-proxy',
-        version: '1.0.1'
+        version: '1.0.2'
       }
     }
   };
@@ -212,6 +227,25 @@ function handlePing(request) {
   }
 }
 
+/**
+ * Handle resources/list method
+ * Returns empty list as resources are not supported yet
+ */
+function handleResourcesList(request) {
+  const response = {
+    jsonrpc: '2.0',
+    id: request.id,
+    result: {
+      resources: []
+    }
+  };
+  
+  process.stdout.write(JSON.stringify(response) + '\n');
+  if (process.stdout.isTTY) {
+    process.stdout.flush();
+  }
+}
+
 /**
  * Process a single JSON-RPC request
  * Forwards the request to the backend MCP API
@@ -302,9 +336,17 @@ async function processSingleRequest(request) {
  * Send JSON-RPC error response
  */
 function sendError(id, code, message) {
+  // Only send error response if id is defined (not for notifications)
+  // Claude Desktop's Zod schema doesn't accept null for id
+  if (id === undefined || id === null) {
+    // For notifications or parse errors without id, don't send response
+    // or send without id field
+    return;
+  }
+  
   const errorResponse = {
     jsonrpc: '2.0',
-    id: id !== undefined ? id : null,
+    id: id,
     error: {
       code: code,
       message: message

package/package.json

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