javabytes-mcp 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 markymakes.dev
+
+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/README.md

@@ -0,0 +1,84 @@
+# javabytes-mcp
+
+JavaBytes is a general-purpose Java MCP server for filesystem work, MySQL
+analysis, JavaFX, Spring Boot and JavaScript-to-Java migration planning. It
+speaks JSON-RPC over stdio and bundles its shaded jar, so a client only needs
+Node.js and Java.
+
+## Requirements
+
+- Node.js 18 or newer
+- Java 21 or newer (`java` on `PATH`, or `JAVA_HOME` set)
+
+## Run
+
+```bash
+npx -y javabytes-mcp
+```
+
+The process reads MCP messages on stdin and writes only protocol messages to
+stdout. Logs go to stderr.
+
+## Agent configuration
+
+```json
+{
+  "mcpServers": {
+    "javabytes": {
+      "command": "npx",
+      "args": ["-y", "javabytes-mcp"],
+      "env": {
+        "JAVABYTES_DB_URL": "jdbc:mysql://localhost:3306/appdb",
+        "JAVABYTES_DB_USER": "app",
+        "JAVABYTES_DB_PASSWORD": "change-me"
+      }
+    }
+  }
+}
+```
+
+Set `JAVABYTES_ALLOWED_DIRS` to a semicolon-separated allow-list when the
+client does not send MCP roots.
+
+## Environment
+
+| Variable | Purpose |
+|---|---|
+| `JAVABYTES_JAR` | Use a specific shaded jar instead of the bundled one |
+| `JAVABYTES_JAVA` | Use a specific `java` executable |
+| `JAVABYTES_JAVA_OPTS` | Extra JVM flags, e.g. `-Xmx512m` |
+| `JAVABYTES_ALLOWED_DIRS` | Fallback filesystem sandbox |
+| `JAVABYTES_DB_URL` | JDBC URL, default `jdbc:mysql://localhost:3306/mydb` |
+| `JAVABYTES_DB_USER` | Database user |
+| `JAVABYTES_DB_PASSWORD` | Database password |
+| `JAVABYTES_ENABLE` | Comma-separated tools/categories to force-enable |
+| `JAVABYTES_DISABLE` | Comma-separated tools/categories to disable |
+| `JAVABYTES_LOG_FILE` | Append protocol/server logs to a file |
+
+Database tools are read-only: they accept `SELECT`, `SHOW`, `DESCRIBE`,
+`EXPLAIN`, `WITH` and `TABLE` statements only.
+
+## Local development
+
+```bash
+npm run prepack        # copy ../../target/javabytes.jar into jar/
+node bin/javabytes.js  # start without npx
+npm test               # launcher unit tests
+```
+
+`prepack` also runs automatically on `npm pack` and `npm publish`.
+
+## Publishing
+
+1. `npm login`
+2. `npm publish --access public`
+
+`prepack` copies the shaded jar and the repository `LICENSE` into the package, so
+both ship in the tarball.
+
+The package name `javabytes-mcp` was unclaimed on npm at the time of writing;
+re-check with `npm view javabytes-mcp` before publishing.
+
+## License
+
+MIT — see [LICENSE](../LICENSE).

package/bin/javabytes.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+"use strict";
+
+const { main } = require("../lib/launcher");
+
+main().then((code) => {
+  process.exitCode = code;
+});

package/lib/launcher.js

@@ -0,0 +1,101 @@
+"use strict";
+
+const fs = require("node:fs");
+const path = require("node:path");
+
+function isFile(candidate) {
+  try {
+    return fs.statSync(candidate).isFile();
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Locate the shaded JavaBytes jar.
+ *
+ * Order: JAVABYTES_JAR, the jar bundled with the npm package, then the
+ * development build in target/.
+ */
+function resolveJar(options = {}) {
+  const env = options.env || process.env;
+  const root = options.root || path.join(__dirname, "..");
+
+  const candidates = [];
+  if (env.JAVABYTES_JAR) {
+    candidates.push(path.resolve(env.JAVABYTES_JAR));
+  }
+  candidates.push(path.join(root, "jar", "javabytes.jar"));
+  candidates.push(path.join(root, "..", "target", "javabytes.jar"));
+
+  return candidates.find(isFile) || null;
+}
+
+/**
+ * Resolve the java executable. JAVABYTES_JAVA wins, then JAVA_HOME, then PATH.
+ */
+function resolveJava(options = {}) {
+  const env = options.env || process.env;
+  if (env.JAVABYTES_JAVA) {
+    return env.JAVABYTES_JAVA;
+  }
+  if (env.JAVA_HOME) {
+    const executable = process.platform === "win32" ? "java.exe" : "java";
+    const candidate = path.join(env.JAVA_HOME, "bin", executable);
+    if (isFile(candidate)) {
+      return candidate;
+    }
+  }
+  return "java";
+}
+
+function buildArgs(jar, argv = [], env = process.env) {
+  const options = (env.JAVABYTES_JAVA_OPTS || "").trim();
+  const jvmArgs = options ? options.split(/\s+/) : [];
+  return [...jvmArgs, "-jar", jar, ...argv];
+}
+
+/**
+ * Spawn the server with inherited stdio so the MCP client owns the pipes.
+ * Resolves with the process exit code.
+ */
+function main(argv = process.argv.slice(2), env = process.env, root) {
+  const jar = resolveJar({ env, root });
+  if (!jar) {
+    console.error("[javabytes] Cannot find javabytes.jar.");
+    console.error("[javabytes] Install a package that bundles the jar, or set JAVABYTES_JAR");
+    console.error("[javabytes] to an existing shaded jar (build one with: mvn package).");
+    return Promise.resolve(1);
+  }
+
+  const java = resolveJava({ env });
+  const { spawn } = require("node:child_process");
+  const child = spawn(java, buildArgs(jar, argv, env), {
+    stdio: "inherit",
+    env,
+    windowsHide: true,
+  });
+
+  const forward = (signal) => {
+    if (child.exitCode === null && child.signalCode === null) {
+      child.kill(signal);
+    }
+  };
+  process.on("SIGINT", () => forward("SIGINT"));
+  process.on("SIGTERM", () => forward("SIGTERM"));
+
+  return new Promise((resolve) => {
+    child.on("error", (error) => {
+      console.error(`[javabytes] Failed to start '${java}': ${error.message}`);
+      if (error.code === "ENOENT") {
+        console.error("[javabytes] Install Java 21+ and put it on PATH, or set JAVA_HOME.");
+      }
+      resolve(127);
+    });
+    child.on("exit", (code) => {
+      resolve(code === null ? 1 : code);
+    });
+  });
+}
+
+module.exports = { resolveJar, resolveJava, buildArgs, main };

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "javabytes-mcp",
+  "version": "1.0.0",
+  "description": "JavaBytes MCP server: filesystem, MySQL analysis, JavaFX, Spring Boot and JavaScript migration tools over stdio.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/markymakes-dev/javabytes.git",
+    "directory": "npm"
+  },
+  "homepage": "https://github.com/markymakes-dev/javabytes#readme",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "java",
+    "mysql",
+    "javafx",
+    "spring-boot"
+  ],
+  "bin": {
+    "javabytes": "bin/javabytes.js"
+  },
+  "files": [
+    "bin",
+    "lib",
+    "jar/javabytes.jar",
+    "LICENSE",
+    "README.md"
+  ],
+  "scripts": {
+    "prepack": "node scripts/copy-jar.js",
+    "test": "node --test test/launcher.test.js"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "os": [
+    "win32",
+    "linux",
+    "darwin"
+  ]
+}