@mctx-ai/mcp-dev 0.5.8 → 1.0.0

package/README.md

@@ -23,8 +23,10 @@ Your server restarts automatically on file changes.
 
 ## What It Does
 
-- **Hot reload** — watches your files and restarts on save
+- **Hot reload** — watches `.js`, `.mjs`, `.cjs`, and `.json` files and restarts on save
 - **Request logging** — logs every MCP request and response to the console
+- **Handler log surfacing** — prints any `log.*()` calls made inside your handlers to the dev console after each request
+- **Sampling stub** — when a tool calls `ask()`, the `/_mctx/sampling` endpoint returns a clear error explaining that sampling is not supported in dev mode
 - **Local testing** — serves your server over HTTP for use with any MCP client
 
 ---

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mctx-ai/mcp-dev",
-  "version": "0.5.8",
+  "version": "1.0.0",
   "description": "Local development server for @mctx-ai/mcp-server with hot reload",
   "type": "module",
   "main": "./src/cli.js",
@@ -14,7 +14,7 @@
     "src"
   ],
   "scripts": {
-    "test": "node --test",
+    "test": "node --test --test-force-exit",
     "lint": "echo 'Linting not configured yet'"
   },
   "keywords": [
@@ -35,11 +35,14 @@
     "url": "https://github.com/mctx-ai/mcp-server/issues"
   },
   "homepage": "https://docs.mctx.ai",
+  "engines": {
+    "node": ">=22.0.0"
+  },
   "publishConfig": {
     "access": "public",
     "provenance": true
   },
   "peerDependencies": {
-    "@mctx-ai/mcp-server": "0.8.0"
+    "@mctx-ai/mcp-server": "^1.0.0"
   }
 }

package/src/server.js

@@ -9,6 +9,7 @@
  */
 
 import { createServer } from "http";
+import { getLogBuffer, clearLogBuffer } from "@mctx-ai/mcp-server";
 import { watch } from "./watcher.js";
 
 // ANSI color codes for logging
@@ -67,6 +68,23 @@ function formatMethod(rpcRequest) {
     return `${method} (${params.name})`;
   }
 
+  // For completion/complete, show ref type and argument name
+  if (method === "completion/complete") {
+    const refType = params?.ref?.type;
+    const argName = params?.argument?.name;
+    if (refType && argName) {
+      return `${method} (${refType}, ${argName})`;
+    }
+    if (refType) {
+      return `${method} (${refType})`;
+    }
+  }
+
+  // For logging/setLevel, show the requested level
+  if (method === "logging/setLevel" && params?.level) {
+    return `${method} (${params.level})`;
+  }
+
   return method;
 }
 
@@ -194,6 +212,41 @@ export async function startDevServer(entryUrl, port) {
 
   // Create HTTP server
   const server = createServer(async (req, res) => {
+    // Handle /_mctx/sampling back-channel: sampling is not supported in dev mode.
+    // Return a JSON-RPC error response so ask() fails with a clear message rather
+    // than a network error.
+    if (req.url === "/_mctx/sampling") {
+      let samplingBody = "";
+      req.on("data", (chunk) => {
+        samplingBody += chunk.toString();
+      });
+      req.on("end", () => {
+        let samplingId = null;
+        try {
+          const parsed = JSON.parse(samplingBody);
+          samplingId = parsed.id || null;
+        } catch {
+          // ignore parse errors — we still send a valid error response
+        }
+        res.writeHead(200, { "Content-Type": "application/json" });
+        res.end(
+          JSON.stringify({
+            jsonrpc: "2.0",
+            error: {
+              code: -32601,
+              message: "Sampling is not supported in dev mode — ask() will return null",
+            },
+            id: samplingId,
+          }),
+        );
+        logFramework(
+          "Sampling request received — sampling is not supported in dev mode",
+          colors.yellow,
+        );
+      });
+      return;
+    }
+
     // Fix #2: If app failed to load initially, return error
     if (!app) {
       res.writeHead(503, { "Content-Type": "application/json" });
@@ -286,6 +339,23 @@ export async function startDevServer(entryUrl, port) {
         return;
       }
 
+      // Validate JSON-RPC method field before dispatching
+      if (!rpcRequest.method || typeof rpcRequest.method !== "string") {
+        res.writeHead(400, { "Content-Type": "application/json" });
+        res.end(
+          JSON.stringify({
+            jsonrpc: "2.0",
+            error: {
+              code: -32600,
+              message: "Invalid Request - Missing or invalid method",
+            },
+            id: rpcRequest.id || null,
+          }),
+        );
+        log(`${colors.red}✗${colors.reset} Invalid Request - missing method`, colors.red);
+        return;
+      }
+
       // Log incoming request
       const methodDisplay = formatMethod(rpcRequest);
       log(`${colors.cyan}→${colors.reset} ${methodDisplay}`, colors.dim);
@@ -316,6 +386,28 @@ export async function startDevServer(entryUrl, port) {
         const statusColor = statusCode >= 200 && statusCode < 300 ? colors.green : colors.red;
         log(`${statusColor}←${colors.reset} ${statusCode} (${elapsed}ms)`, colors.dim);
 
+        // Surface buffered log entries from handler code to dev console
+        const bufferedLogs = getLogBuffer();
+        clearLogBuffer();
+        if (bufferedLogs.length > 0) {
+          for (const entry of bufferedLogs) {
+            const levelColor =
+              entry.level === "error" ||
+              entry.level === "critical" ||
+              entry.level === "alert" ||
+              entry.level === "emergency"
+                ? colors.red
+                : entry.level === "warning"
+                  ? colors.yellow
+                  : colors.dim;
+            const dataStr =
+              typeof entry.data === "string" ? entry.data : JSON.stringify(entry.data);
+            console.log(
+              `${colors.gray}[${timestamp()}]${colors.reset} ${levelColor}[log:${entry.level}]${colors.reset} ${dataStr}`,
+            );
+          }
+        }
+
         // Verbose logging: log full response body (skip initialize/initialized)
         if (
           isVerbose &&

package/src/watcher.js

@@ -104,8 +104,9 @@ export function watch(filePath, onChange) {
   // Watch each directory
   for (const { path, recursive } of watchDirs) {
     const watcher = fsWatch(path, { recursive }, (eventType, changedFile) => {
-      // Only watch .js files
-      if (changedFile && !changedFile.endsWith(".js")) {
+      // Only watch .js, .mjs, .cjs, and .json files
+      const watchedExtensions = [".js", ".mjs", ".cjs", ".json"];
+      if (changedFile && !watchedExtensions.some((ext) => changedFile.endsWith(ext))) {
         return;
       }