watermarkbuster-mcp 1.0.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 Rigale (Watermark Buster interface, web service, and design)
+Copyright (c) 2026 watermarks-remover contributors (cleaning engine)
+
+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,69 @@
+# Watermark Buster MCP
+
+Connect a local MCP client to the hosted Watermark Buster tools. The package is a bridge. It does not run the cleaning engine on your computer.
+
+## Requirements
+
+- Node.js 20 or newer
+- An internet connection to `https://watermarkbuster.com/mcp`
+
+No account, API token, GPU, Python, or local model is required.
+
+## Use with `npx`
+
+Set these values in your MCP client:
+
+```text
+Command: npx
+Arguments: -y watermarkbuster-mcp
+```
+
+For clients that use an `mcpServers` JSON object, the matching form is:
+
+```json
+{
+  "mcpServers": {
+    "watermark-buster": {
+      "command": "npx",
+      "args": ["-y", "watermarkbuster-mcp"]
+    }
+  }
+}
+```
+
+The MCP client starts the command. Running it in a normal terminal shows no user interface because it waits for MCP messages on standard input.
+
+## Install first
+
+```bash
+npm install --global watermarkbuster-mcp
+```
+
+Then set the MCP command to:
+
+```text
+watermarkbuster-mcp
+```
+
+## Tools
+
+The bridge reads the current tool list from the hosted MCP server when it starts. The current tools are:
+
+- `inspect_text`
+- `clean_text`
+- `clean_file`
+- `get_capabilities`
+
+## Data flow
+
+Tool input is sent to `https://watermarkbuster.com` for processing. The hosted service processes content for the call and does not archive it. Do not use this npm bridge if content must stay on your computer.
+
+For clients that support remote Streamable HTTP MCP, connect directly to `https://watermarkbuster.com/mcp` instead.
+
+## Connection errors
+
+If the hosted service cannot be reached, the command writes `Watermark Buster MCP: <reason>` to standard error and exits with a failure status. Check that `https://watermarkbuster.com/mcp` is reachable, then let the MCP client start the command again.
+
+## License
+
+MIT

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "watermarkbuster-mcp",
+  "version": "1.0.0",
+  "description": "Connect local MCP clients to the hosted Watermark Buster tools.",
+  "type": "module",
+  "bin": {
+    "watermarkbuster-mcp": "src/cli.js"
+  },
+  "files": [
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "check": "node --check src/cli.js && node --check src/server.js",
+    "test": "node --test"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "watermark",
+    "metadata",
+    "unicode"
+  ],
+  "homepage": "https://watermarkbuster.com/mcp",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/client": "2.0.0",
+    "@modelcontextprotocol/server": "2.0.0"
+  }
+}

package/src/cli.js

@@ -0,0 +1,66 @@
+#!/usr/bin/env node
+
+import {
+  Client,
+  StreamableHTTPClientTransport,
+} from "@modelcontextprotocol/client";
+import { serveStdio } from "@modelcontextprotocol/server/stdio";
+
+import {
+  PACKAGE_VERSION,
+  REMOTE_MCP_ENDPOINT,
+  createBridgeServer,
+} from "./server.js";
+
+function reportFailure(error) {
+  const message = error instanceof Error ? error.message : String(error);
+  console.error(`Watermark Buster MCP: ${message}`);
+}
+
+function reportShutdownOutcomes(shutdownOutcomes) {
+  for (const shutdownOutcome of shutdownOutcomes) {
+    if (shutdownOutcome.status === "rejected") {
+      reportFailure(shutdownOutcome.reason);
+      process.exitCode = 1;
+    }
+  }
+}
+
+function registerShutdown(stdioHandle, remoteClient) {
+  let shutdownStarted = false;
+  const shutdown = async () => {
+    if (shutdownStarted) return;
+    shutdownStarted = true;
+    const shutdownOutcomes = await Promise.allSettled([
+      stdioHandle.close(),
+      remoteClient.close(),
+    ]);
+    reportShutdownOutcomes(shutdownOutcomes);
+  };
+
+  process.stdin.once("end", () => void shutdown());
+  process.once("SIGINT", () => void shutdown());
+  process.once("SIGTERM", () => void shutdown());
+}
+
+async function startBridge() {
+  const remoteClient = new Client({
+    name: "watermarkbuster-mcp",
+    version: PACKAGE_VERSION,
+  });
+  const remoteTransport = new StreamableHTTPClientTransport(
+    new URL(REMOTE_MCP_ENDPOINT),
+  );
+  await remoteClient.connect(remoteTransport);
+  const { tools } = await remoteClient.listTools();
+  const stdioHandle = serveStdio(
+    () => createBridgeServer(remoteClient, tools),
+    { onerror: reportFailure },
+  );
+  registerShutdown(stdioHandle, remoteClient);
+}
+
+startBridge().catch((error) => {
+  reportFailure(error);
+  process.exitCode = 1;
+});

package/src/server.js

@@ -0,0 +1,56 @@
+import { createRequire } from "node:module";
+
+import { McpServer, fromJsonSchema } from "@modelcontextprotocol/server";
+
+const require = createRequire(import.meta.url);
+const packageMetadata = require("../package.json");
+
+export const REMOTE_MCP_ENDPOINT = "https://watermarkbuster.com/mcp";
+export const PACKAGE_VERSION = packageMetadata.version;
+
+const SERVER_INSTRUCTIONS = [
+  "This local bridge forwards Watermark Buster tool calls to",
+  `${REMOTE_MCP_ENDPOINT}. Content leaves this machine for processing.`,
+  "The hosted service does not archive submitted content.",
+].join(" ");
+
+function remoteToolConfiguration(remoteTool) {
+  const configuration = {
+    title: remoteTool.title,
+    description: remoteTool.description,
+    inputSchema: fromJsonSchema(remoteTool.inputSchema),
+    annotations: remoteTool.annotations,
+    icons: remoteTool.icons,
+    _meta: remoteTool._meta,
+  };
+  if (remoteTool.outputSchema) {
+    configuration.outputSchema = fromJsonSchema(remoteTool.outputSchema);
+  }
+  return configuration;
+}
+
+function remoteToolHandler(remoteClient, remoteToolName) {
+  return (toolArguments, context) => remoteClient.callTool(
+    { name: remoteToolName, arguments: toolArguments },
+    { signal: context.mcpReq.signal },
+  );
+}
+
+export function createBridgeServer(remoteClient, remoteTools) {
+  const bridgeServer = new McpServer({
+    name: "watermarkbuster-mcp",
+    title: "Watermark Buster",
+    version: PACKAGE_VERSION,
+    description: "Connect local MCP clients to the hosted Watermark Buster tools.",
+    websiteUrl: "https://watermarkbuster.com/mcp",
+  }, { instructions: SERVER_INSTRUCTIONS });
+
+  for (const remoteTool of remoteTools) {
+    bridgeServer.registerTool(
+      remoteTool.name,
+      remoteToolConfiguration(remoteTool),
+      remoteToolHandler(remoteClient, remoteTool.name),
+    );
+  }
+  return bridgeServer;
+}