mcp-docs-service 0.2.13 → 0.2.14

package/cursor-wrapper.js

@@ -0,0 +1,84 @@
+#!/usr/bin/env node
+
+/**
+ * Cursor Wrapper for MCP Docs Service
+ *
+ * This script is designed to be used as the entry point for Cursor's MCP integration.
+ * It handles the arguments properly and forwards them to the actual MCP Docs Service.
+ */
+
+import fs from "fs";
+import path from "path";
+import { spawn } from "child_process";
+import { fileURLToPath } from "url";
+
+// Get the current directory
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+// Create a log file for debugging
+const logFile = path.join(__dirname, "cursor-debug.log");
+fs.writeFileSync(
+  logFile,
+  `Cursor wrapper called at ${new Date().toISOString()}\n`
+);
+fs.appendFileSync(logFile, `Arguments: ${JSON.stringify(process.argv)}\n`);
+fs.appendFileSync(logFile, `Working directory: ${process.cwd()}\n`);
+
+// Extract the docs directory from the arguments
+// The docs directory is expected to be the last argument
+let docsDir = "./docs";
+const args = process.argv.slice(2);
+
+if (args.length > 0) {
+  // Check if --docs-dir flag is used
+  const docsDirIndex = args.indexOf("--docs-dir");
+  if (docsDirIndex !== -1 && docsDirIndex + 1 < args.length) {
+    docsDir = args[docsDirIndex + 1];
+  } else {
+    // Otherwise, use the last argument if it looks like a path
+    const lastArg = args[args.length - 1];
+    if (!lastArg.startsWith("-")) {
+      docsDir = lastArg;
+    }
+  }
+}
+
+// Resolve the docs directory to an absolute path
+docsDir = path.resolve(docsDir);
+fs.appendFileSync(logFile, `Using docs directory: ${docsDir}\n`);
+
+// Ensure the docs directory exists
+if (!fs.existsSync(docsDir)) {
+  fs.appendFileSync(logFile, `Creating docs directory: ${docsDir}\n`);
+  try {
+    fs.mkdirSync(docsDir, { recursive: true });
+  } catch (error) {
+    fs.appendFileSync(logFile, `Error creating docs directory: ${error}\n`);
+    process.exit(1);
+  }
+}
+
+// Set up the arguments for the actual service
+const serviceArgs = ["--docs-dir", docsDir];
+fs.appendFileSync(
+  logFile,
+  `Service arguments: ${JSON.stringify(serviceArgs)}\n`
+);
+
+// Run the actual service
+const binPath = path.join(__dirname, "dist", "cli", "bin.js");
+fs.appendFileSync(
+  logFile,
+  `Running service: ${binPath} ${serviceArgs.join(" ")}\n`
+);
+
+const child = spawn("node", [binPath, ...serviceArgs], {
+  stdio: "inherit",
+  env: { ...process.env, MCP_CURSOR_INTEGRATION: "true" },
+});
+
+child.on("exit", (code) => {
+  fs.appendFileSync(logFile, `Child process exited with code ${code}\n`);
+  process.exit(code);
+});

package/mcp-inspector-wrapper.js

@@ -0,0 +1,68 @@
+#!/usr/bin/env node
+
+/**
+ * MCP Inspector Wrapper
+ *
+ * This script is a wrapper for the MCP Docs Service that handles the MCP Inspector's argument format.
+ * It extracts the docs directory from the arguments and passes it to the MCP Docs Service.
+ */
+
+import path from "path";
+import { spawn } from "child_process";
+import fs from "fs";
+import { fileURLToPath } from "url";
+
+// Get the current directory
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+// Redirect logs to stderr instead of stdout to avoid interfering with JSON communication
+const log = (...args) => {
+  console.error(...args);
+};
+
+// Get all arguments
+const args = process.argv.slice(2);
+log("MCP Inspector Wrapper - Arguments:", args);
+
+// Find the docs directory in the arguments
+let docsDir = path.join(process.cwd(), "docs");
+let foundDocsDir = false;
+
+// Look for a path ending with /docs
+for (const arg of args) {
+  if (arg.endsWith("/docs") || arg.includes("/docs ")) {
+    const potentialPath = arg.split(" ")[0];
+    log("Found potential docs path:", potentialPath);
+    if (fs.existsSync(potentialPath)) {
+      docsDir = potentialPath;
+      foundDocsDir = true;
+      log("Using docs directory:", docsDir);
+      break;
+    }
+  }
+}
+
+if (!foundDocsDir) {
+  log("No docs directory found in arguments, using default:", docsDir);
+}
+
+// Spawn the MCP Docs Service with the docs directory
+const binPath = path.join(__dirname, "dist", "cli", "bin.js");
+log("Spawning MCP Docs Service:", binPath, "--docs-dir", docsDir);
+
+// Set environment variable to indicate we're running under MCP Inspector
+const env = { ...process.env, MCP_INSPECTOR: "true" };
+
+// Spawn the process with stdio inheritance
+// This ensures that the JSON communication between the MCP Inspector and the service
+// is not interrupted by our logs
+const child = spawn("node", [binPath, "--docs-dir", docsDir], {
+  stdio: "inherit",
+  env,
+});
+
+// Forward exit code
+child.on("exit", (code) => {
+  process.exit(code);
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-docs-service",
-  "version": "0.2.13",
+  "version": "0.2.14",
   "description": "MCP Documentation Management Service - A Model Context Protocol implementation for documentation management",
   "type": "module",
   "main": "dist/index.js",