browser-console-mcp 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Yolin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/bin/browser-mcp-server.js

@@ -0,0 +1,75 @@
+#!/usr/bin/env node
+
+/**
+ * Browser MCP Server CLI
+ *
+ * Command line entry point for the browser MCP server
+ */
+
+import { spawn } from "node:child_process";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+// Get current file directory
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const rootDir = join(__dirname, "..");
+
+// Command line arguments
+const args = process.argv.slice(2);
+const port =
+	args.find((arg) => !arg.startsWith("-")) || process.env.PORT || "7898";
+
+// Set environment variables
+process.env.PORT = port;
+
+// Ensure stdout is only used for JSON messages
+const originalStdoutWrite = process.stdout.write.bind(process.stdout);
+process.stdout.write = (chunk, encoding, callback) => {
+	// Only allow JSON messages through
+	if (typeof chunk === "string" && !chunk.startsWith("{")) {
+		process.stderr.write(chunk); // Redirect non-JSON messages to stderr
+		return true;
+	}
+	return originalStdoutWrite(chunk, encoding, callback);
+};
+
+// Start browser MCP server
+console.error(`Starting Browser MCP server, listening on port ${port}...`);
+
+// Ensure stdio is correctly passed
+const child = spawn("node", [join(rootDir, "dist/browser/index.js")], {
+	stdio: ["inherit", "inherit", "inherit"], // Ensure stdin, stdout, stderr are all correctly passed
+	env: { ...process.env, PORT: port },
+});
+
+// Handle child process events
+child.on("error", (err) => {
+	console.error("Failed to start child process:", err);
+	process.exit(1);
+});
+
+child.on("exit", (code, signal) => {
+	if (code !== null) {
+		console.error(`Child process exited with code: ${code}`);
+	} else if (signal !== null) {
+		console.error(`Child process terminated by signal: ${signal}`);
+	}
+	process.exit(code || 0);
+});
+
+// Pass parent process signals to child process
+process.on("SIGINT", () => {
+	child.kill("SIGINT");
+});
+
+process.on("SIGTERM", () => {
+	child.kill("SIGTERM");
+});
+
+// Handle parent process exit
+process.on("exit", () => {
+	if (!child.killed) {
+		child.kill();
+	}
+});

package/bin/cli.js

@@ -0,0 +1,65 @@
+#!/usr/bin/env node
+
+/**
+ * Browser Console MCP CLI
+ *
+ * Command line entry point for starting the MCP server
+ * Supports running directly through npx or after global installation
+ *
+ * Usage:
+ * - Global installation: browser-console-mcp start
+ * - npx: npx browser-console-mcp start
+ */
+
+import { spawn } from "node:child_process";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+// Get current file directory
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const rootDir = join(__dirname, "..");
+
+// Command line arguments
+const args = process.argv.slice(2);
+const command = args[0] || "help";
+
+// Process command
+switch (command) {
+	case "start":
+		// Start server-side MCP server
+		console.log("Starting Browser Console MCP server...");
+		spawn("node", [join(rootDir, "dist/server/index.js")], {
+			stdio: "inherit",
+		});
+		break;
+
+	case "start:browser":
+		// Start browser MCP server
+		console.log("Starting Browser MCP server...");
+		spawn("node", [join(rootDir, "dist/browser/index.js")], {
+			stdio: "inherit",
+		});
+		break;
+
+	default:
+		console.log(`
+Browser Console MCP CLI
+
+Usage:
+  browser-console-mcp <command> [options]
+  npx browser-console-mcp <command> [options]
+
+Commands:
+  start           Start server-side MCP server
+  start:browser   Start browser MCP server
+  help            Display help information
+
+Examples:
+  browser-console-mcp start
+  npx browser-console-mcp start
+  browser-console-mcp start:browser
+  npx browser-console-mcp start:browser
+    `);
+		break;
+}

package/bin/copy-html2canvas.js

@@ -0,0 +1,51 @@
+/**
+ * Copy html2canvas to static resources directory
+ */
+
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+// Get current file directory
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const projectRoot = path.resolve(__dirname, "..");
+
+// Source file path
+const sourcePath = path.join(
+	projectRoot,
+	"node_modules",
+	"html2canvas",
+	"dist",
+	"html2canvas.min.js",
+);
+
+// Target directory
+const targetDir = path.join(projectRoot, "dist", "static");
+const targetPath = path.join(targetDir, "html2canvas.min.js");
+
+// Ensure target directory exists
+function ensureDirectoryExists(dirPath) {
+	if (!fs.existsSync(dirPath)) {
+		fs.mkdirSync(dirPath, { recursive: true });
+		console.log(`Creating directory: ${dirPath}`);
+	}
+}
+
+// Copy file
+function copyFile(source, target) {
+	try {
+		const data = fs.readFileSync(source);
+		fs.writeFileSync(target, data);
+		console.log(`File copied successfully: ${source} -> ${target}`);
+	} catch (error) {
+		console.error(`Failed to copy file: ${error.message}`);
+		process.exit(1);
+	}
+}
+
+// Execute copy
+console.log("Starting to copy html2canvas...");
+ensureDirectoryExists(targetDir);
+copyFile(sourcePath, targetPath);
+console.log("html2canvas copy completed");

package/dist/browser/browser-inject.js

@@ -0,0 +1,34 @@
+/**
+ * Browser MCP 注入脚本
+ *
+ * 这个脚本用于在浏览器中注入MCP客户端
+ */
+
+(() => {
+	// 检查是否已经加载了MCP客户端
+	if (window.mcp) {
+		console.log("[Browser MCP] MCP客户端已加载");
+		return;
+	}
+
+	// 获取当前脚本的URL，以确定服务器地址
+	const currentScript = document.currentScript;
+	const scriptUrl = currentScript ? currentScript.src : "";
+	const serverUrl = scriptUrl
+		? new URL(scriptUrl).origin
+		: "http://localhost:7898";
+
+	// 加载MCP客户端脚本
+	const script = document.createElement("script");
+	script.src = `${serverUrl}/browser-console-mcp.js`;
+	script.onload = () => {
+		console.log("[Browser MCP] MCP客户端加载成功");
+	};
+	script.onerror = (error) => {
+		console.error("[Browser MCP] MCP客户端加载失败:", error);
+	};
+
+	document.head.appendChild(script);
+
+	console.log("[Browser MCP] 正在加载MCP客户端...");
+})();