@drop2run/mcp 0.1.1 → 0.3.0

package/README.md

@@ -59,7 +59,7 @@ effect without a restart.
 
 | Tool | What it does |
 |---|---|
-| `publish_html` | Publishes one HTML document as a site. It becomes `index.html` |
+| `publish_files` | Publishes files Claude wrote — a page, a markdown note, several files together |
 | `publish_dir` | Publishes a folder, given its absolute path |
 | `list_sites` | Lists the sites on the account |
 
@@ -71,8 +71,12 @@ new site is created.
 **Publishing without a `site` creates a new one.** It never replaces your most recent site by default:
 "put this online" is not "and overwrite what I published last time".
 
-**A folder can be documents instead of a built site.** `publish_dir` wants an `index.html` at the top
-level, or at least one `.md`, `.markdown` or `.pdf` file — those are served through the reader.
+**A site can be documents instead of a built site.** A publish needs an `index.html` at the top level,
+or at least one `.md`, `.markdown` or `.pdf` file — those are served through the reader. So a single
+note is a whole site, and Claude does not have to wrap it in HTML to publish it.
+
+**`publish_files` is text.** A PDF or an image has to come off a disk with `publish_dir`, because these
+files arrive as JSON strings.
 
 **The URL comes back immediately; every edge has it in about a minute.** The reply also says whether a
 new version was published, or every file already matched what the site serves.

package/dist/index.js

@@ -200,6 +200,56 @@ function isDocumentPath(path) {
   const lower = path.toLowerCase();
   return DOCUMENT_EXTENSIONS.some((extension) => lower.endsWith(extension));
 }
+const VIEWABLE_EXTENSIONS = [
+  // Documents — these also count at any depth, via DOCUMENT_EXTENSIONS.
+  ".md",
+  ".markdown",
+  ".pdf",
+  // Prose the reader shows preformatted.
+  ".txt",
+  ".log",
+  ".csv",
+  // Source the reader shows with highlighting.
+  ".json",
+  ".yaml",
+  ".yml",
+  ".toml",
+  ".css",
+  ".js",
+  ".ts",
+  ".tsx",
+  ".jsx",
+  ".sh",
+  ".xml",
+  // Pictures the reader shows with an img element.
+  ".png",
+  ".jpg",
+  ".jpeg",
+  ".gif",
+  ".webp",
+  ".avif",
+  ".svg",
+  ".ico",
+  // See the note above: a floor for a caller that did not rename it.
+  ".html",
+  ".htm"
+];
+function isViewablePath(path) {
+  const lower = path.toLowerCase();
+  return VIEWABLE_EXTENSIONS.some((extension) => lower.endsWith(extension));
+}
+function canPublish(paths) {
+  if (paths.some((path) => path === REQUIRED_INDEX)) return true;
+  if (paths.some(isDocumentPath)) return true;
+  return paths.length === 1 && paths[0] !== void 0 && isViewablePath(paths[0]);
+}
+function renameOfLoneHtmlPage(paths) {
+  if (paths.length !== 1) return null;
+  const [only] = paths;
+  if (only === void 0 || only === REQUIRED_INDEX) return null;
+  const lower = only.toLowerCase();
+  return lower.endsWith(".html") || lower.endsWith(".htm") ? only : null;
+}
 function formatBytes(bytes) {
   if (bytes < 1024) return `${bytes} B`;
   if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`;
@@ -213,11 +263,10 @@ function checkLimits(files, limits) {
       "That drop contained no files to deploy. Folders like .git and node_modules are skipped."
     );
   }
-  const hasIndex = files.some((file) => file.path === REQUIRED_INDEX);
-  if (!hasIndex && !files.some((file) => isDocumentPath(file.path))) {
+  if (!canPublish(files.map((file) => file.path))) {
     throw new DeployError(
       ClientErrorCode.MissingIndex,
-      `A site needs an ${REQUIRED_INDEX} at its top level, or at least one .md or .pdf file to publish as a documents site. Drop the folder that contains it, not the folder above.`
+      `A site needs an ${REQUIRED_INDEX} at its top level, or at least one .md or .pdf file to publish as a documents site — or be a single file that can be displayed on its own, such as a note, a PDF, a page or an image. Drop the folder that contains it, not the folder above.`
     );
   }
   if (!limits) return;
@@ -228,9 +277,7 @@ function checkLimits(files, limits) {
       { limit: limits.maxFiles, actual: files.length }
     );
   }
-  const oversized = files.find(
-    (file) => file.bytes.length > limits.maxFileBytes
-  );
+  const oversized = files.find((file) => file.bytes.length > limits.maxFileBytes);
   if (oversized) {
     throw new DeployError(
       ClientErrorCode.FileTooLarge,
@@ -459,8 +506,10 @@ function asDeployError(error) {
 }
 async function deploy(source, siteId, onProgress, signal, options = {}) {
   try {
-    const files = await source(signal);
-    onProgress({ type: "collecting", files: files.length });
+    const collected = await source(signal);
+    onProgress({ type: "collecting", files: collected.length });
+    const rename = renameOfLoneHtmlPage(collected.map((file) => file.path));
+    const files = rename === null ? collected : collected.map((file) => file.path === rename ? { ...file, path: "index.html" } : file);
     const hashed = await hashAll(
       files,
       (done, total) => onProgress({ type: "hashing", done, total }),
@@ -595,11 +644,32 @@ async function publish(credentials, source, site) {
 function publishDirectory(credentials, directory, site) {
   return publish(credentials, directorySource(directory), site);
 }
-function publishHtml(credentials, html, site) {
-  const bytes = new TextEncoder().encode(html);
-  return publish(credentials, async () => [{ path: "index.html", bytes }], site);
+function cleanPath(path) {
+  const cleaned = path.trim().replaceAll("\\", "/").replace(/^\.?\//, "");
+  if (cleaned === "" || cleaned.endsWith("/")) {
+    throw new Error(`"${path}" does not name a file.`);
+  }
+  if (cleaned.split("/").includes("..") || /^[a-zA-Z]:/.test(cleaned)) {
+    throw new Error(
+      `"${path}" is not a path inside the site. Give a path relative to the site's root, such as index.html or docs/guide.md.`
+    );
+  }
+  return cleaned;
 }
-const SERVER_VERSION = "0.1.1";
+async function publishFiles(credentials, files, site) {
+  const encoder = new TextEncoder();
+  const collected = files.map((file) => ({
+    path: cleanPath(file.path),
+    bytes: encoder.encode(file.content)
+  }));
+  const seen = /* @__PURE__ */ new Set();
+  for (const file of collected) {
+    if (seen.has(file.path)) throw new Error(`Two files were given the same path: ${file.path}`);
+    seen.add(file.path);
+  }
+  return publish(credentials, async () => collected, site);
+}
+const SERVER_VERSION = "0.3.0";
 function say(text, isError = false) {
   return { content: [{ type: "text", text }], ...isError ? { isError: true } : {} };
 }
@@ -629,9 +699,14 @@ function createServer() {
       instructions: [
         "Publishes static sites to Drop2Run.",
         "",
-        "Use publish_html for a single page you have written, and publish_dir for a folder that is",
-        "already built. Leave `site` unset to publish to a brand-new site; pass a subdomain to",
-        "publish over an existing one. list_sites shows what already exists.",
+        "Use publish_files for anything you wrote here — a page, a markdown note, several files",
+        "together — and publish_dir for a folder that already exists on disk. Leave `site` unset to",
+        "publish to a brand-new site; pass a subdomain to publish over an existing one. list_sites",
+        "shows what already exists.",
+        "",
+        "A site needs an index.html at its top level, or at least one .md, .markdown or .pdf file,",
+        "which publishes as a documents site and is read through a viewer. So one page goes at",
+        "index.html, and a single note is a whole publish that needs no wrapping in HTML.",
         "",
         "Publishing over an existing site replaces what it serves, so ask before doing that to a",
         "site the person did not name."
@@ -639,16 +714,23 @@ function createServer() {
     }
   );
   server.registerTool(
-    "publish_html",
+    "publish_files",
     {
-      title: "Publish a page",
-      description: "Publishes one HTML page as a whole site and returns its URL. The page becomes index.html.",
+      title: "Publish files you wrote",
+      description: "Publishes one or more files written here — markdown, HTML, CSS, JSON — as a site, and returns its URL. A single page goes at index.html; a single .md, .markdown or .pdf file is a site on its own, served through the documents viewer. Text only: a PDF or an image has to be published from disk with publish_dir.",
       inputSchema: {
-        html: z.string().min(1).describe("The complete HTML document to publish."),
+        files: z.array(
+          z.object({
+            path: z.string().min(1).describe("Path inside the site, such as index.html or docs/guide.md."),
+            content: z.string().describe("The file's contents.")
+          })
+        ).min(1).describe("The files to publish."),
         site: z.string().optional().describe("Subdomain or site id to publish over. Omit to create a new site.")
       }
     },
-    ({ html, site }) => withCredentials(async (credentials) => describe(await publishHtml(credentials, html, site)))
+    ({ files, site }) => withCredentials(
+      async (credentials) => describe(await publishFiles(credentials, files, site))
+    )
   );
   server.registerTool(
     "publish_dir",

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@drop2run/mcp",
-	"version": "0.1.1",
+	"version": "0.3.0",
 	"description": "MCP server that publishes a folder or an HTML page to Drop2Run and returns a live URL.",
 	"license": "MIT",
 	"type": "module",
@@ -18,6 +18,13 @@
 		"access": "public"
 	},
 	"homepage": "https://dropto.run",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/Drop-to-run/drop2run-cli.git"
+	},
+	"bugs": {
+		"url": "https://github.com/Drop-to-run/drop2run-cli/issues"
+	},
 	"keywords": [
 		"mcp",
 		"ai",