@reidar80/webshelf-mcp 0.1.0 → 0.2.0

package/dist/api.d.ts

@@ -12,6 +12,7 @@ export interface ApiFile {
     collectionId: string | null;
     ownerId: string;
     protection: "public" | "authenticated" | "inherit" | "individual";
+    format: "html" | "markdown";
     sizeBytes: number;
     createdAt: string;
     updatedAt: string;
@@ -52,14 +53,16 @@ export interface ApiClient {
     }>;
     getFileContent(id: string): Promise<{
         name: string;
-        html: string;
+        content: string;
+        format: ApiFile["format"];
     }>;
     createFile(input: {
         name: string;
         description?: string | null;
         collectionId: string | null;
         protection?: ApiFile["protection"];
-        html: string;
+        format?: ApiFile["format"];
+        content: string;
     }): Promise<{
         file: ApiFile;
     }>;

package/dist/api.js

@@ -61,8 +61,8 @@ export function createApiClient(options) {
         getFile: (id) => request("GET", `/api/v1/files/${id}`),
         getFileContent: async (id) => {
             const json = await request("GET", `/api/v1/files/${id}/content?as=base64`);
-            const html = Buffer.from(json.contentBase64, "base64").toString("utf8");
-            return { name: json.name, html };
+            const content = Buffer.from(json.contentBase64, "base64").toString("utf8");
+            return { name: json.name, content, format: json.format };
         },
         createFile: (input) => request("POST", "/api/v1/files", input),
         updateFile: (id, input) => request("PATCH", `/api/v1/files/${id}`, input),

package/dist/index.d.ts

@@ -17,8 +17,8 @@
  *   webshelf_list_collections — list collections the caller can write to
  *   webshelf_list_files     — list files (own / by collection)
  *   webshelf_get_file       — metadata for a single file
- *   webshelf_read_file      — fetch HTML contents
- *   webshelf_create_file    — upload a new HTML file
+ *   webshelf_read_file      — fetch file contents (HTML or markdown)
+ *   webshelf_create_file    — upload a new HTML or markdown file
  *   webshelf_update_file    — rename / move / re-describe
  *   webshelf_delete_file    — soft-delete a file (recycle bin)
  */

package/dist/index.js

@@ -17,8 +17,8 @@
  *   webshelf_list_collections — list collections the caller can write to
  *   webshelf_list_files     — list files (own / by collection)
  *   webshelf_get_file       — metadata for a single file
- *   webshelf_read_file      — fetch HTML contents
- *   webshelf_create_file    — upload a new HTML file
+ *   webshelf_read_file      — fetch file contents (HTML or markdown)
+ *   webshelf_create_file    — upload a new HTML or markdown file
  *   webshelf_update_file    — rename / move / re-describe
  *   webshelf_delete_file    — soft-delete a file (recycle bin)
  */
@@ -84,7 +84,7 @@ const tools = [
                 .parse(input ?? {});
             const { files, nextCursor } = await client.listFiles(parsed);
             const body = files
-                .map((f) => `${f.id}  ${JSON.stringify(f.name)}  collection=${f.collectionId ?? "(personal)"}  ${formatBytes(f.sizeBytes)}  ${f.protection}  updated=${f.updatedAt}`)
+                .map((f) => `${f.id}  ${JSON.stringify(f.name)}  format=${f.format}  collection=${f.collectionId ?? "(personal)"}  ${formatBytes(f.sizeBytes)}  ${f.protection}  updated=${f.updatedAt}`)
                 .join("\n") || "(no files match)";
             return text(nextCursor ? `${body}\n\nnextCursor=${nextCursor}` : body);
         },
@@ -108,7 +108,7 @@ const tools = [
     },
     {
         name: "webshelf_read_file",
-        description: "Return the HTML body of a file by id. The response is returned as a text block; the MCP client can save it, render it, or feed it back into a tool call.",
+        description: "Return the contents of a file by id. Returns the raw source — HTML for `format=html` files, markdown for `format=markdown` files. The response is a text block; the MCP client can save it, render it, or feed it back into a tool call.",
         inputSchema: {
             type: "object",
             additionalProperties: false,
@@ -119,17 +119,18 @@ const tools = [
         },
         handler: async (input) => {
             const { id } = z.object({ id: z.string().uuid() }).parse(input);
-            const { html, name } = await client.getFileContent(id);
-            return text(`Filename: ${name}.html\n\n${html}`);
+            const { content, name, format } = await client.getFileContent(id);
+            const ext = format === "markdown" ? "md" : "html";
+            return text(`Filename: ${name}.${ext}\nFormat: ${format}\n\n${content}`);
         },
     },
     {
         name: "webshelf_create_file",
-        description: "Upload a new HTML file. Set collectionId to a uuid to place inside a collection (caller must be owner/manager), or null for a standalone personal file. Returns the created file's metadata.",
+        description: "Upload a new file. `format` may be \"html\" (default) or \"markdown\"; pass the bytes in `content`. Set collectionId to a uuid to place inside a collection (caller must be owner/manager), or null for a standalone personal file. Returns the created file's metadata.",
         inputSchema: {
             type: "object",
             additionalProperties: false,
-            required: ["name", "html"],
+            required: ["name", "content"],
             properties: {
                 name: { type: "string", minLength: 1, maxLength: 200 },
                 description: { type: "string", maxLength: 2000 },
@@ -138,7 +139,8 @@ const tools = [
                     type: "string",
                     enum: ["public", "authenticated", "inherit", "individual"],
                 },
-                html: { type: "string" },
+                format: { type: "string", enum: ["html", "markdown"] },
+                content: { type: "string" },
             },
         },
         handler: async (input) => {
@@ -150,11 +152,12 @@ const tools = [
                 protection: z
                     .enum(["public", "authenticated", "inherit", "individual"])
                     .optional(),
-                html: z.string().min(1),
+                format: z.enum(["html", "markdown"]).optional(),
+                content: z.string().min(1),
             })
                 .parse(input);
             const { file } = await client.createFile(parsed);
-            return text(`Created file ${file.id} (${file.name}) — ${formatBytes(file.sizeBytes)}\n${BASE_URL}/app/files/${file.id}`);
+            return text(`Created ${file.format} file ${file.id} (${file.name}) — ${formatBytes(file.sizeBytes)}\n${BASE_URL}/app/files/${file.id}`);
         },
     },
     {
@@ -203,7 +206,7 @@ const tools = [
 ];
 const server = new Server({
     name: "@reidar80/webshelf-mcp",
-    version: "0.1.0",
+    version: "0.2.0",
 }, {
     capabilities: {
         tools: {},

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@reidar80/webshelf-mcp",
-  "version": "0.1.0",
-  "description": "Model Context Protocol server for Webshelf — list, read, upload and manage HTML files hosted on webshelf.app from any MCP-aware client.",
+  "version": "0.2.0",
+  "description": "Model Context Protocol server for Webshelf — list, read, upload and manage HTML and markdown files hosted on webshelf.app from any MCP-aware client.",
   "keywords": [
     "mcp",
     "model-context-protocol",