@proofofprotocol/inscribe-mcp 0.3.4 → 0.3.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@proofofprotocol/inscribe-mcp",
-  "version": "0.3.4",
+  "version": "0.3.5",
   "description": "Verifiable inscription for AI agents - inscribe anything to blockchain with Hedera HCS",
   "type": "module",
   "main": "src/server.js",

package/src/lib/logger.js

@@ -5,7 +5,7 @@
  * Used by MCP Server to record all tool executions.
  */
 
-import { existsSync, mkdirSync, appendFileSync } from 'fs';
+import { existsSync, mkdirSync, appendFileSync, readFileSync } from 'fs';
 import { homedir } from 'os';
 import { join } from 'path';
 
@@ -80,6 +80,41 @@ export function logToolExecution({
   });
 }
 
+/**
+ * Check if debug mode is enabled (config or env)
+ */
+function isDebugEnabled() {
+  // Environment variable takes precedence
+  if (process.env.INSCRIBE_MCP_DEBUG === '1' || process.env.INSCRIBE_MCP_DEBUG === 'true') {
+    return true;
+  }
+
+  // Check config file
+  const configPath = join(homedir(), '.inscribe-mcp', 'config.json');
+  if (!existsSync(configPath)) {
+    return false;
+  }
+
+  try {
+    const config = JSON.parse(readFileSync(configPath, 'utf-8'));
+    if (!config.debug || !config.debug.enabled) {
+      return false;
+    }
+
+    // Check expiry
+    if (config.debug.expiresAt) {
+      const expiry = new Date(config.debug.expiresAt);
+      if (Date.now() > expiry.getTime()) {
+        return false; // Expired
+      }
+    }
+
+    return true;
+  } catch {
+    return false;
+  }
+}
+
 /**
  * Log a debug sequence trace
  * @param {Object} options - Debug trace options
@@ -90,10 +125,13 @@ export function logDebugTrace({
   payload = null,
   status = null,
   txId = null,
-  result = null
+  result = null,
+  duration = null,
+  args = null,
+  error = null
 }) {
   // Only log if debug mode is enabled
-  if (!process.env.INSCRIBE_MCP_DEBUG) return;
+  if (!isDebugEnabled()) return;
 
   writeLog({
     level: 'debug',
@@ -102,7 +140,10 @@ export function logDebugTrace({
     payload,
     status,
     txId,
-    result
+    result,
+    duration,
+    args,
+    error
   });
 }
 

package/src/server.js

@@ -20,6 +20,9 @@ import { existsSync, readFileSync } from 'fs';
 import { homedir } from 'os';
 import { join } from 'path';
 
+// Logger for file-based debug traces (import early for use in debugLog)
+import { logDebugTrace } from './lib/logger.js';
+
 /**
  * Check if debug mode is enabled (config or env)
  */
@@ -56,7 +59,7 @@ function isDebugEnabled() {
 }
 
 /**
- * Debug log to stderr (safe for MCP stdio transport)
+ * Debug log to stderr AND file (safe for MCP stdio transport)
  * Checks config on each call for hot-reload support
  */
 function debugLog(phase, data = {}) {
@@ -71,6 +74,16 @@ function debugLog(phase, data = {}) {
 
   // Output to stderr to avoid interfering with MCP JSON-RPC over stdout
   console.error(`[DEBUG] ${JSON.stringify(message)}`);
+
+  // Also write to file for `inscribe-mcp show --debug`
+  logDebugTrace({
+    phase,
+    tool: data.tool,
+    args: data.args,
+    status: data.status,
+    duration: data.duration,
+    error: data.error
+  });
 }
 
 // Layer 1 Tools (Primary)
@@ -223,7 +236,7 @@ async function main() {
   if (isDebugEnabled()) {
     console.error('Debug mode is currently ON (hot-reloadable)');
     debugLog('server_start', {
-      version: '0.3.4',
+      version: '0.3.5',
       tools: allTools.map(t => t.name)
     });
   }