@aiquants/html-to-markdown 0.2.6 → 0.4.0

package/dist/src/mcp-server-streamable.d.ts

@@ -1,5 +1,6 @@
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { CallToolResult, Progress, Tool } from '@modelcontextprotocol/sdk/types.js';
+import { HtmlToMarkdownArgs, SaveContentArgs, UrlToMarkdownFileArgs } from './mcp-common.ts';
 /**
  * The context for a tool call.
  * ツール呼び出しのコンテキスト
@@ -7,24 +8,12 @@ import { CallToolResult, Progress, Tool } from '@modelcontextprotocol/sdk/types.
 export type ToolContext<T = unknown> = {
     [toolName: string]: T;
 };
-/**
- * Arguments for HTML to Markdown conversion tool.
- * HTML から Markdown への変換ツールの引数
- */
-interface HtmlToMarkdownArgs {
-    url?: string;
-    html_content?: string;
-    locale?: "en-US" | "ja-JP";
-    output_format?: "markdown" | "html" | "both";
-    save_path?: string;
-    save_directory?: string;
-}
 /**
  * Extended Tool interface with handler function.
  * ハンドラー関数を含む拡張 Tool インターフェース
  */
 interface ExtendedTool extends Tool {
-    handler: (args: HtmlToMarkdownArgs, context: ToolContext<HtmlToMarkdownArgs>) => AsyncGenerator<Progress | {
+    handler: (args: HtmlToMarkdownArgs | SaveContentArgs | UrlToMarkdownFileArgs, context: ToolContext<HtmlToMarkdownArgs | SaveContentArgs | UrlToMarkdownFileArgs>) => AsyncGenerator<Progress | {
         type: "result";
         result: CallToolResult;
     }>;
@@ -57,6 +46,27 @@ export declare class StreamableHtmlToMarkdownMcpServer {
         type: "result";
         result: CallToolResult;
     }>;
+    /**
+     * Handle save content to file tool call with streamable support.
+     * streamable サポート付きのファイル保存ツール呼び出しを処理
+     */
+    handleSaveContentToFile(args: SaveContentArgs, _context: ToolContext<SaveContentArgs>): AsyncGenerator<Progress | {
+        type: "result";
+        result: CallToolResult;
+    }>;
+    /**
+     * Handle URL to Markdown file conversion tool call with streamable support.
+     * streamable サポート付きの URL から Markdown ファイルへの変換ツール呼び出しを処理
+     */
+    handleUrlToMarkdownFile(args: UrlToMarkdownFileArgs, _context: ToolContext<UrlToMarkdownFileArgs>): AsyncGenerator<Progress | {
+        type: "result";
+        result: CallToolResult;
+    }>;
+    /**
+     * Generate filename from URL.
+     * URL からファイル名を生成
+     */
+    private generateFilenameFromUrl;
     /**
      * Start the streamable MCP server.
      * streamable MCP サーバーを開始

package/dist/src/mcp-server.d.ts

@@ -1,21 +1,6 @@
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
-/**
- * Arguments for HTML to Markdown conversion tool.
- * HTML から Markdown への変換ツールの引数
- */
-interface HtmlToMarkdownArgs {
-    url?: string;
-    html_content?: string;
-    locale?: "en-US" | "ja-JP";
-    output_format?: "markdown" | "html" | "both";
-    save_path?: string;
-    save_directory?: string;
-}
-/**
- * Validate and parse arguments for HTML to Markdown conversion.
- * HTML から Markdown への変換の引数を検証・解析
- */
-export declare function parseHtmlToMarkdownArgs(args: HtmlToMarkdownArgs | undefined): HtmlToMarkdownArgs;
+import { HtmlToMarkdownArgs, SaveContentArgs, UrlToMarkdownFileArgs } from './mcp-common.ts';
+export { type HtmlToMarkdownArgs, type SaveContentArgs, type UrlToMarkdownFileArgs, parseHtmlToMarkdownArgs, parseSaveContentArgs, parseUrlToMarkdownFileArgs, saveContentToFile, createErrorResult, createSuccessResult, MCP_TOOL_SCHEMAS, } from './mcp-common.ts';
 /**
  * MCP Server for HTML to Markdown conversion.
  * HTML から Markdown への変換を行う MCP サーバー
@@ -34,12 +19,222 @@ export declare class HtmlToMarkdownMcpServer {
      * HTML から Markdown への変換ツール呼び出しを処理
      */
     handleHtmlToMarkdown(args: HtmlToMarkdownArgs | undefined): Promise<{
-        content: {
-            type: string;
+        [x: string]: unknown;
+        content: ({
+            [x: string]: unknown;
             text: string;
-        }[];
-        isError: boolean;
+            type: "text";
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            [x: string]: unknown;
+            type: "image";
+            data: string;
+            mimeType: string;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            [x: string]: unknown;
+            type: "audio";
+            data: string;
+            mimeType: string;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            [x: string]: unknown;
+            type: "resource_link";
+            name: string;
+            uri: string;
+            title?: string | undefined;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+            mimeType?: string | undefined;
+            description?: string | undefined;
+        } | {
+            [x: string]: unknown;
+            type: "resource";
+            resource: {
+                [x: string]: unknown;
+                text: string;
+                uri: string;
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+                mimeType?: string | undefined;
+            } | {
+                [x: string]: unknown;
+                uri: string;
+                blob: string;
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+                mimeType?: string | undefined;
+            };
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        })[];
+        _meta?: {
+            [x: string]: unknown;
+        } | undefined;
+        structuredContent?: {
+            [x: string]: unknown;
+        } | undefined;
+        isError?: boolean | undefined;
     }>;
+    /**
+     * Handle save content to file tool call.
+     * ファイル保存ツール呼び出しを処理
+     */
+    handleSaveContentToFile(args: SaveContentArgs | undefined): Promise<{
+        [x: string]: unknown;
+        content: ({
+            [x: string]: unknown;
+            text: string;
+            type: "text";
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            [x: string]: unknown;
+            type: "image";
+            data: string;
+            mimeType: string;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            [x: string]: unknown;
+            type: "audio";
+            data: string;
+            mimeType: string;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            [x: string]: unknown;
+            type: "resource_link";
+            name: string;
+            uri: string;
+            title?: string | undefined;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+            mimeType?: string | undefined;
+            description?: string | undefined;
+        } | {
+            [x: string]: unknown;
+            type: "resource";
+            resource: {
+                [x: string]: unknown;
+                text: string;
+                uri: string;
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+                mimeType?: string | undefined;
+            } | {
+                [x: string]: unknown;
+                uri: string;
+                blob: string;
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+                mimeType?: string | undefined;
+            };
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        })[];
+        _meta?: {
+            [x: string]: unknown;
+        } | undefined;
+        structuredContent?: {
+            [x: string]: unknown;
+        } | undefined;
+        isError?: boolean | undefined;
+    }>;
+    /**
+     * Handle URL to Markdown file conversion tool call.
+     * URL から Markdown ファイルへの変換ツール呼び出しを処理
+     */
+    handleUrlToMarkdownFile(args: UrlToMarkdownFileArgs | undefined): Promise<{
+        [x: string]: unknown;
+        content: ({
+            [x: string]: unknown;
+            text: string;
+            type: "text";
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            [x: string]: unknown;
+            type: "image";
+            data: string;
+            mimeType: string;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            [x: string]: unknown;
+            type: "audio";
+            data: string;
+            mimeType: string;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            [x: string]: unknown;
+            type: "resource_link";
+            name: string;
+            uri: string;
+            title?: string | undefined;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+            mimeType?: string | undefined;
+            description?: string | undefined;
+        } | {
+            [x: string]: unknown;
+            type: "resource";
+            resource: {
+                [x: string]: unknown;
+                text: string;
+                uri: string;
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+                mimeType?: string | undefined;
+            } | {
+                [x: string]: unknown;
+                uri: string;
+                blob: string;
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+                mimeType?: string | undefined;
+            };
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        })[];
+        _meta?: {
+            [x: string]: unknown;
+        } | undefined;
+        structuredContent?: {
+            [x: string]: unknown;
+        } | undefined;
+        isError?: boolean | undefined;
+    }>;
+    /**
+     * Generate filename from URL.
+     * URL からファイル名を生成
+     */
+    private generateFilenameFromUrl;
     /**
      * Start the MCP server.
      * MCP サーバーを開始
@@ -56,4 +251,3 @@ export declare const createMcpServer: () => HtmlToMarkdownMcpServer;
  * MCP サーバーを実行するメイン関数
  */
 export declare const runMcpServer: () => Promise<void>;
-export {};

package/dist/{version-PCzxchJe.js → version-BSh9aXhF.js}

@@ -6,8 +6,10 @@ Object.assign(global, {
   self: window
 });
 import { b as getDefaultExportFromCjs } from "./core-CouDTni-.js";
+import { promises } from "fs";
+import { resolve, dirname } from "path";
 import { readFileSync } from "node:fs";
-import { dirname, resolve } from "node:path";
+import { dirname as dirname$1, resolve as resolve$1 } from "node:path";
 import { fileURLToPath } from "node:url";
 var util$1;
 (function(util2) {
@@ -11290,11 +11292,223 @@ class Server extends Protocol {
     return this.notification({ method: "notifications/prompts/list_changed" });
   }
 }
+function parseHtmlToMarkdownArgs(args) {
+  if (!args || typeof args !== "object") {
+    throw new Error("Arguments are required");
+  }
+  const { url, html_content, locale = "en-US" } = args;
+  if (!url && !html_content) {
+    throw new Error("Either 'url' or 'html_content' is required");
+  }
+  if (url && typeof url !== "string") {
+    throw new Error("'url' must be a string");
+  }
+  if (html_content && typeof html_content !== "string") {
+    throw new Error("'html_content' must be a string");
+  }
+  if (locale && !["en-US", "ja-JP"].includes(locale)) {
+    throw new Error("'locale' must be 'en-US' or 'ja-JP'");
+  }
+  return {
+    url,
+    html_content,
+    locale
+  };
+}
+function parseSaveContentArgs(args) {
+  if (!args || typeof args !== "object") {
+    throw new Error("Arguments are required");
+  }
+  const { content, save_path, save_directory, filename } = args;
+  if (!content || typeof content !== "string") {
+    throw new Error("'content' is required and must be a string");
+  }
+  if (!save_path && !save_directory) {
+    throw new Error("Either 'save_path' or 'save_directory' is required");
+  }
+  if (save_path && typeof save_path !== "string") {
+    throw new Error("'save_path' must be a string");
+  }
+  if (save_directory && typeof save_directory !== "string") {
+    throw new Error("'save_directory' must be a string");
+  }
+  if (filename && typeof filename !== "string") {
+    throw new Error("'filename' must be a string");
+  }
+  if (save_path && save_directory) {
+    throw new Error("Cannot specify both 'save_path' and 'save_directory'");
+  }
+  return {
+    content,
+    save_path,
+    save_directory,
+    filename
+  };
+}
+function parseUrlToMarkdownFileArgs(args) {
+  if (!args || typeof args !== "object") {
+    throw new Error("Arguments are required");
+  }
+  const { url, html_content, locale = "en-US", save_path, save_directory, filename } = args;
+  if (!url && !html_content) {
+    throw new Error("Either 'url' or 'html_content' is required");
+  }
+  if (url && typeof url !== "string") {
+    throw new Error("'url' must be a string");
+  }
+  if (html_content && typeof html_content !== "string") {
+    throw new Error("'html_content' must be a string");
+  }
+  if (locale && !["en-US", "ja-JP"].includes(locale)) {
+    throw new Error("'locale' must be 'en-US' or 'ja-JP'");
+  }
+  if (!save_path && !save_directory) {
+    throw new Error("Either 'save_path' or 'save_directory' is required");
+  }
+  if (save_path && typeof save_path !== "string") {
+    throw new Error("'save_path' must be a string");
+  }
+  if (save_directory && typeof save_directory !== "string") {
+    throw new Error("'save_directory' must be a string");
+  }
+  if (filename && typeof filename !== "string") {
+    throw new Error("'filename' must be a string");
+  }
+  if (save_path && save_directory) {
+    throw new Error("Cannot specify both 'save_path' and 'save_directory'");
+  }
+  return {
+    url,
+    html_content,
+    locale,
+    save_path,
+    save_directory,
+    filename
+  };
+}
+function generateFilename(url) {
+  return "page";
+}
+async function saveContentToFile(content, savePath, saveDirectory, filename) {
+  let finalPath;
+  if (savePath) {
+    finalPath = resolve(savePath);
+  } else if (saveDirectory) {
+    const baseFilename = filename || generateFilename();
+    const extension = ".md";
+    finalPath = resolve(saveDirectory, `${baseFilename}${extension}`);
+  } else {
+    throw new Error("Either save_path or save_directory must be specified");
+  }
+  await promises.mkdir(dirname(finalPath), { recursive: true });
+  await promises.writeFile(finalPath, content, "utf-8");
+  return finalPath;
+}
+const MCP_TOOL_SCHEMAS = {
+  htmlToMarkdown: {
+    type: "object",
+    properties: {
+      url: {
+        type: "string",
+        description: "URL of the web page to convert (e.g., https://example.com). Handles JavaScript-rendered dynamic content effectively."
+      },
+      html_content: {
+        type: "string",
+        description: "HTML string to convert directly. Use instead of URL for local files or API response HTML content."
+      },
+      locale: {
+        type: "string",
+        description: "Browser locale setting. Use 'ja-JP' for Japanese sites, 'en-US' for English sites. Affects content rendering and language detection.",
+        enum: ["en-US", "ja-JP"],
+        default: "en-US"
+      }
+    },
+    anyOf: [{ required: ["url"] }, { required: ["html_content"] }]
+  },
+  saveContentToFile: {
+    type: "object",
+    properties: {
+      content: {
+        type: "string",
+        description: "Text content to save to file. Will be saved as Markdown format."
+      },
+      save_path: {
+        type: "string",
+        description: "Complete file path including filename to save content (e.g., '/home/user/output.md'). Cannot be used with save_directory."
+      },
+      save_directory: {
+        type: "string",
+        description: "Directory path to save content with auto-generated filename (e.g., '/home/user/downloads'). Cannot be used with save_path."
+      },
+      filename: {
+        type: "string",
+        description: "Base filename to use when save_directory is specified (e.g., 'my-document'). Extension .md will be added automatically."
+      }
+    },
+    required: ["content"],
+    anyOf: [{ required: ["save_path"] }, { required: ["save_directory"] }]
+  },
+  urlToMarkdownFile: {
+    type: "object",
+    properties: {
+      url: {
+        type: "string",
+        description: "URL of the web page to convert and save as Markdown file (e.g., https://example.com). Handles JavaScript-rendered dynamic content effectively."
+      },
+      html_content: {
+        type: "string",
+        description: "HTML string to convert directly and save as Markdown file. Use instead of URL for local files or API response HTML content."
+      },
+      locale: {
+        type: "string",
+        description: "Browser locale setting. Use 'ja-JP' for Japanese sites, 'en-US' for English sites. Affects content rendering and language detection.",
+        enum: ["en-US", "ja-JP"],
+        default: "en-US"
+      },
+      save_path: {
+        type: "string",
+        description: "Complete file path including filename to save the converted Markdown content (e.g., '/home/user/output.md'). Cannot be used with save_directory."
+      },
+      save_directory: {
+        type: "string",
+        description: "Directory path to save the converted Markdown content with auto-generated filename (e.g., '/home/user/downloads'). Cannot be used with save_path."
+      },
+      filename: {
+        type: "string",
+        description: "Base filename to use when save_directory is specified (e.g., 'my-document'). Extension .md will be added automatically."
+      }
+    },
+    anyOf: [{ required: ["url", "save_path"] }, { required: ["url", "save_directory"] }, { required: ["html_content", "save_path"] }, { required: ["html_content", "save_directory"] }]
+  }
+};
+function createErrorResult(error) {
+  const errorMessage = error instanceof Error ? error.message : String(error);
+  return {
+    content: [
+      {
+        type: "text",
+        text: `Error: ${errorMessage}`
+      }
+    ],
+    isError: true
+  };
+}
+function createSuccessResult(text) {
+  return {
+    content: [
+      {
+        type: "text",
+        text
+      }
+    ],
+    isError: false
+  };
+}
 const getPackageVersion = () => {
   try {
     const __filename = fileURLToPath(import.meta.url);
-    const __dirname = dirname(__filename);
-    const packageJsonPath = resolve(__dirname, "../package.json");
+    const __dirname = dirname$1(__filename);
+    const packageJsonPath = resolve$1(__dirname, "../package.json");
     const packageJson = JSON.parse(readFileSync(packageJsonPath, "utf-8"));
     return packageJson.version || "0.0.0";
   } catch (error) {
@@ -11308,11 +11522,18 @@ export {
   InitializeRequestSchema as I,
   JSONRPCMessageSchema as J,
   ListToolsRequestSchema as L,
+  MCP_TOOL_SCHEMAS as M,
   Server as S,
-  isJSONRPCRequest as a,
-  SUPPORTED_PROTOCOL_VERSIONS as b,
-  isJSONRPCResponse as c,
-  isJSONRPCError as d,
+  createErrorResult as a,
+  parseSaveContentArgs as b,
+  createSuccessResult as c,
+  parseUrlToMarkdownFileArgs as d,
+  isJSONRPCRequest as e,
+  SUPPORTED_PROTOCOL_VERSIONS as f,
   getPackageVersion as g,
-  isInitializeRequest as i
+  isJSONRPCResponse as h,
+  isInitializeRequest as i,
+  isJSONRPCError as j,
+  parseHtmlToMarkdownArgs as p,
+  saveContentToFile as s
 };