markdown-new-mcp 1.0.0

package/.memsearch/memory/2026-02-24.md

@@ -0,0 +1,129 @@
+
+## Session 11:48
+
+
+## Session 11:51
+
+
+## Session 11:59
+
+### 11:59
+<!-- session:86a058f1-3f79-4cae-ba47-1cd9f184fff8 turn:8da4a43a-27c1-443e-8819-1890118e2af5 transcript:/Volumes/JJZ/jerryjiang/.claude/projects/-Volumes-JJZ-jerryjiang-unicom-dev-markdown-new-mcp/86a058f1-3f79-4cae-ba47-1cd9f184fff8.jsonl -->
+- 用户要求将 markdown.new 的文件转 Markdown API 封装成 MCP 服务器
+- 项目目录已创建在 /Volumes/JJZ/jerryjiang/unicom/dev/markdown-new-mcp/
+- 分析了 markdown.new 的 API：POST `/` 端点用于直接上传转换，POST `/convert` 端点用于 URL 转换，支持 PDF、DOCX、XLSX、图片等格式，最大 10MB
+- API 认证方式：Authorization: Bearer mk_... header 或 ?api_key=mk_... query 参数
+- 探索了现有 MCP 项目结构和 TypeScript MCP SDK 的标准结构
+- 创建了实现计划文件在 /Volumes/JJZ/jerryjiang/.claude/plans/iterative-strolling-ritchie.md
+- 用户要求完成后使用 GITHUB_TOKEN 创建新的 GitHub repo
+
+
+## Session 12:00
+
+
+## Session 12:04
+
+### 12:04
+<!-- session:e002accd-e739-4d6b-b854-87ea20879102 turn:769ba1cd-fe58-48df-a768-6f1411077b43 transcript:/Volumes/JJZ/jerryjiang/.claude/projects/-Volumes-JJZ-jerryjiang-unicom-dev-markdown-new-mcp/e002accd-e739-4d6b-b854-87ea20879102.jsonl -->
+- 创建了 MCP 服务器项目，目录位于 /Volumes/JJZ/jerryjiang/unicom/dev/markdown-new-mcp/
+- 实现了三个 MCP 工具：`convert_url_to_markdown`（URL转Markdown）、`convert_file_to_markdown`（文件上传转换）、`convert_url_to_json`（带元数据的URL转换）
+- 修复了 TypeScript 编译错误（unknown 类型问题），添加了 `extractMarkdown` 辅助函数处理 API 响应
+- 使用 GitHub API 创建了公开仓库 https://github.com/takltc/markdown-new-mcp
+- 初始提交包含 6 个文件：package.json、tsconfig.json、.gitignore、README.md、src/index.ts、package-lock.json
+- 代码已成功推送到 GitHub main 分支
+
+
+## Session 12:47
+
+### 12:47
+<!-- session:e002accd-e739-4d6b-b854-87ea20879102 turn:d13fe578-465c-4010-8084-9f15f4845eb1 transcript:/Volumes/JJZ/jerryjiang/.claude/projects/-Volumes-JJZ-jerryjiang-unicom-dev-markdown-new-mcp/e002accd-e739-4d6b-b854-87ea20879102.jsonl -->
+- 将 markdown-new-mcp MCP 服务器部署到 ms 服务器 (64.69.41.84)
+- 修改了 src/index.ts 从 stdio 传输改为 SSE HTTP 传输，支持网络访问
+- 在服务器 /opt/markdown-new-mcp 目录部署项目，创建了 systemd 服务
+- 服务监听端口 38721，健康检查和 SSE 端点已验证可从本地访问
+- 在 ~/.ssh/config 添加了 SSH 隧道配置 (Host mcp-markdown) 用于本地端口转发
+- 服务地址: http://64.69.41.84:38721，健康检查: /health，SSE: /sse
+
+
+## Session 12:50
+
+### 12:50
+<!-- session:e002accd-e739-4d6b-b854-87ea20879102 turn:89a137f1-0cf3-4189-b070-98cbf66419dc transcript:/Volumes/JJZ/jerryjiang/.claude/projects/-Volumes-JJZ-jerryjiang-unicom-dev-markdown-new-mcp/e002accd-e739-4d6b-b854-87ea20879102.jsonl -->
+- 创建了 MCP 包装脚本 `~/.local/bin/markdown-new-mcp`，通过 SSH 直接执行远程服务器的 stdio 模式 MCP
+- 将 `src/index.ts` 修改为支持 SSE HTTP 传输模式，服务监听端口 38721
+- 在 `~/.claude/settings.json` 添加了 `mcpServers` 配置，指向本地脚本
+- 在 `~/.ssh/config` 添加了 `mcp-markdown` SSH 隧道配置（备用方案）
+- 服务部署在 ms 服务器 `/opt/markdown-new-mcp` 目录，通过 systemd 管理
+- 三个 MCP 工具可用：`convert_url_to_markdown`、`convert_file_to_markdown`、`convert_url_to_json`
+
+
+## Session 12:52
+
+### 12:52
+<!-- session:e002accd-e739-4d6b-b854-87ea20879102 turn:9ae6efd3-4ded-4d98-bf6e-fa7cf23d9aee transcript:/Volumes/JJZ/jerryjiang/.claude/projects/-Volumes-JJZ-jerryjiang-unicom-dev-markdown-new-mcp/e002accd-e739-4d6b-b854-87ea20879102.jsonl -->
+- 初始代码已提交推送到 GitHub main 分支
+- SSE 支持的修改尚未提交，需要用户确认是否提交
+
+
+## Session 12:52
+
+### 12:52
+<!-- session:e002accd-e739-4d6b-b854-87ea20879102 turn:f4043bb2-918c-4c1d-bdb7-991789f223ac transcript:/Volumes/JJZ/jerryjiang/.claude/projects/-Volumes-JJZ-jerryjiang-unicom-dev-markdown-new-mcp/e002accd-e739-4d6b-b854-87ea20879102.jsonl -->
+- 将 markdown-new-mcp MCP 服务器部署到 ms 服务器 (64.69.41.84)
+- 修改 `src/index.ts` 从 stdio 传输改为 SSE HTTP 传输，支持网络访问
+- 在服务器 `/opt/markdown-new-mcp` 目录部署项目，创建了 systemd 服务
+- 服务监听端口 38721，健康检查和 SSE 端点已验证可从本地访问
+- 创建了 MCP 包装脚本 `~/.local/bin/markdown-new-mcp`，通过 SSH 直接执行远程 stdio 模式 MCP
+- 在 `~/.claude/settings.json` 添加了 `mcpServers` 配置，指向本地脚本
+- 在 `~/.ssh/config` 添加了 `mcp-markdown` SSH 隧道配置（备用方案）
+- SSE 支持修改已提交推送: `b4056e2 Add SSE transport support for remote deployment`
+
+
+## Session 12:54
+
+
+## Session 12:54
+
+
+## Session 12:55
+
+### 12:55
+<!-- session:e002accd-e739-4d6b-b854-87ea20879102 turn:4e8d94d7-a1d0-45a2-b802-e86972a329ce transcript:/Volumes/JJZ/jerryjiang/.claude/projects/-Volumes-JJZ-jerryjiang-unicom-dev-markdown-new-mcp/e002accd-e739-4d6b-b854-87ea20879102.jsonl -->
+- 将 markdown-new-mcp MCP 服务器部署到 ms 服务器 (64.69.41.84)，修改 `src/index.ts` 从 stdio 传输改为 SSE HTTP 传输
+- 在服务器 `/opt/markdown-new-mcp` 目录部署项目，创建 systemd 服务监听端口 38721
+- 创建本地包装脚本 `~/.local/bin/markdown-new-mcp`，通过 SSH 直接执行远程 stdio 模式 MCP
+- 在 `~/.claude/settings.json` 添加 `mcpServers` 配置指向本地脚本
+- SSE 支持修改已提交推送: `b4056e2 Add SSE transport support for remote deployment`
+- README 中的 npx 使用方式不可用，因为包未发布到 npm，只推送到了 GitHub
+
+
+## Session 13:01
+
+
+## Session 13:01
+
+
+## Session 13:02
+
+### 13:02
+<!-- session:e002accd-e739-4d6b-b854-87ea20879102 turn:10f9cd55-6edd-4c38-93d0-0452ed89d396 transcript:/Volumes/JJZ/jerryjiang/.claude/projects/-Volumes-JJZ-jerryjiang-unicom-dev-markdown-new-mcp/e002accd-e739-4d6b-b854-87ea20879102.jsonl -->
+- 将 markdown-new-mcp MCP 服务器部署到 ms 服务器 (64.69.41.84)，修改 `src/index.ts` 从 stdio 传输改为 SSE HTTP 传输
+- 在服务器 `/opt/markdown-new-mcp` 目录部署项目，创建 systemd 服务监听端口 38721
+- 创建本地包装脚本 `~/.local/bin/markdown-new-mcp`，通过 SSH 直接执行远程 stdio 模式 MCP
+- 在 `~/.claude/settings.json` 添加 `mcpServers` 配置指向本地脚本
+- SSE 支持修改已提交推送: `b4056e2 Add SSE transport support for remote deployment`
+- README 中的 npx 使用方式不可用，因为包未发布到 npm，只推送到了 GitHub
+
+
+## Session 13:03
+
+### 13:03
+<!-- session:e002accd-e739-4d6b-b854-87ea20879102 turn:2a5dc373-3eb6-410b-8c5a-4c6064772fb7 transcript:/Volumes/JJZ/jerryjiang/.claude/projects/-Volumes-JJZ-jerryjiang-unicom-dev-markdown-new-mcp/e002accd-e739-4d6b-b854-87ea20879102.jsonl -->
+- 将 markdown-new-mcp MCP 服务器部署到 ms 服务器 (64.69.41.84)，修改 `src/index.ts` 从 stdio 传输改为 SSE HTTP 传输
+- 在服务器 `/opt/markdown-new-mcp` 目录部署项目，创建 systemd 服务监听端口 38721
+- 创建本地包装脚本 `~/.local/bin/markdown-new-mcp`，通过 SSH 直接执行远程 stdio 模式 MCP
+- 在 `~/.claude/settings.json` 添加 `mcpServers` 配置指向本地脚本
+- SSE 支持修改已提交推送: `b4056e2 Add SSE transport support for remote deployment`
+- README 中的 npx 使用方式不可用，因为包未发布到 npm，只推送到了 GitHub
+- 尝试用 npm token 发布失败，需要带有 bypass 2FA 权限的 Granular Access Token
+

package/README.md

@@ -0,0 +1,110 @@
+# markdown-new-mcp
+
+MCP (Model Context Protocol) server for [markdown.new](https://markdown.new) file conversion API. Convert PDF, DOCX, XLSX, images and 20+ formats to Markdown.
+
+## Installation
+
+```bash
+npm install markdown-new-mcp
+```
+
+## Usage
+
+### With Claude Desktop
+
+Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):
+
+```json
+{
+  "mcpServers": {
+    "markdown-new": {
+      "command": "npx",
+      "args": ["markdown-new-mcp"]
+    }
+  }
+}
+```
+
+### With API Key (Optional)
+
+For higher rate limits, you can provide an API key:
+
+```json
+{
+  "mcpServers": {
+    "markdown-new": {
+      "command": "npx",
+      "args": ["markdown-new-mcp"],
+      "env": {
+        "MARKDOWN_NEW_API_KEY": "mk_your_api_key_here"
+      }
+    }
+  }
+}
+```
+
+## Available Tools
+
+### `convert_url_to_markdown`
+
+Convert a remote file URL to Markdown.
+
+**Parameters:**
+- `url` (string, required): The URL of the remote file to convert
+- `api_key` (string, optional): API key for higher rate limits
+
+**Example:**
+```
+Convert this PDF to markdown: https://example.com/document.pdf
+```
+
+### `convert_file_to_markdown`
+
+Convert a local file to Markdown.
+
+**Parameters:**
+- `file_path` (string, required): The absolute path to the local file
+- `api_key` (string, optional): API key for higher rate limits
+
+**Example:**
+```
+Convert /path/to/document.pdf to markdown
+```
+
+### `convert_url_to_json`
+
+Convert a remote file URL to JSON with metadata (title, tokens, duration, etc).
+
+**Parameters:**
+- `url` (string, required): The URL of the remote file
+- `api_key` (string, optional): API key for higher rate limits
+
+## Supported Formats
+
+- **Documents:** PDF, DOCX, ODT
+- **Spreadsheets:** XLSX, XLS, XLSM, XLSB, ET, ODS, Numbers
+- **Images:** JPG, JPEG, PNG, WebP, SVG
+- **Text/Data:** TXT, MD, CSV, JSON, XML, HTML, HTM
+
+## Limits
+
+- **Without API Key:** 500 requests/day per IP
+- **With API Key:** Higher limits available
+- **Maximum File Size:** 10MB
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Run locally
+npm run dev
+```
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,272 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { SSEServerTransport } from "@modelcontextprotocol/sdk/server/sse.js";
+import { z } from "zod";
+import fs from "fs/promises";
+import path from "path";
+import { statSync } from "fs";
+import http from "http";
+const MARKDOWN_NEW_BASE_URL = "https://markdown.new";
+function extractMarkdown(data) {
+    if (typeof data === "string") {
+        return data;
+    }
+    if (typeof data === "object" && data !== null) {
+        const obj = data;
+        if (typeof obj.markdown === "string") {
+            return obj.markdown;
+        }
+        if (typeof obj.content === "string") {
+            return obj.content;
+        }
+    }
+    return JSON.stringify(data, null, 2);
+}
+function createServer() {
+    const server = new McpServer({
+        name: "markdown-new-mcp",
+        version: "1.0.0",
+    });
+    server.tool("convert_url_to_markdown", "Convert a remote file URL to Markdown. Supports PDF, DOCX, XLSX, images and 20+ formats. Maximum file size: 10MB.", {
+        url: z.string().url().describe("The URL of the remote file to convert"),
+        api_key: z.string().optional().describe("Optional API key for higher rate limits (format: mk_...)"),
+    }, async ({ url, api_key }) => {
+        try {
+            const headers = {
+                "Content-Type": "application/json",
+            };
+            if (api_key) {
+                headers["Authorization"] = `Bearer ${api_key}`;
+            }
+            const response = await fetch(MARKDOWN_NEW_BASE_URL, {
+                method: "POST",
+                headers,
+                body: JSON.stringify({ url }),
+            });
+            if (!response.ok) {
+                const errorText = await response.text();
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Error converting URL: ${response.status} ${response.statusText}\n${errorText}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            const data = await response.json();
+            const markdown = extractMarkdown(data);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: markdown,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Failed to convert URL to Markdown: ${errorMessage}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    server.tool("convert_file_to_markdown", "Convert a local file to Markdown. Supports PDF, DOCX, XLSX, images and 20+ formats. Maximum file size: 10MB.", {
+        file_path: z.string().describe("The absolute path to the local file to convert"),
+        api_key: z.string().optional().describe("Optional API key for higher rate limits (format: mk_...)"),
+    }, async ({ file_path, api_key }) => {
+        try {
+            let fileStats;
+            try {
+                fileStats = statSync(file_path);
+            }
+            catch {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `File not found: ${file_path}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            const MAX_FILE_SIZE = 10 * 1024 * 1024;
+            if (fileStats.size > MAX_FILE_SIZE) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `File too large: ${file_path} (${(fileStats.size / 1024 / 1024).toFixed(2)}MB). Maximum size is 10MB.`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            const fileContent = await fs.readFile(file_path);
+            const fileName = path.basename(file_path);
+            const formData = new FormData();
+            const blob = new Blob([fileContent]);
+            formData.append("file", blob, fileName);
+            const headers = {};
+            if (api_key) {
+                headers["Authorization"] = `Bearer ${api_key}`;
+            }
+            const response = await fetch(`${MARKDOWN_NEW_BASE_URL}/convert`, {
+                method: "POST",
+                headers,
+                body: formData,
+            });
+            if (!response.ok) {
+                const errorText = await response.text();
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Error converting file: ${response.status} ${response.statusText}\n${errorText}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            const data = await response.json();
+            const markdown = extractMarkdown(data);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: markdown,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Failed to convert file to Markdown: ${errorMessage}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    server.tool("convert_url_to_json", "Convert a remote file URL to JSON with metadata (title, tokens, duration, etc). Supports PDF, DOCX, XLSX, images and 20+ formats.", {
+        url: z.string().url().describe("The URL of the remote file to convert"),
+        api_key: z.string().optional().describe("Optional API key for higher rate limits (format: mk_...)"),
+    }, async ({ url, api_key }) => {
+        try {
+            const encodedUrl = encodeURIComponent(url);
+            const requestUrl = `${MARKDOWN_NEW_BASE_URL}/${encodedUrl}?format=json`;
+            const headers = {};
+            if (api_key) {
+                headers["Authorization"] = `Bearer ${api_key}`;
+            }
+            const response = await fetch(requestUrl, {
+                method: "GET",
+                headers,
+            });
+            if (!response.ok) {
+                const errorText = await response.text();
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Error converting URL: ${response.status} ${response.statusText}\n${errorText}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            const data = await response.json();
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(data, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Failed to convert URL to JSON: ${errorMessage}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    return server;
+}
+async function runStdio() {
+    const server = createServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+async function runSSE(port) {
+    const httpServer = http.createServer(async (req, res) => {
+        if (req.method === "GET" && req.url === "/health") {
+            res.writeHead(200, { "Content-Type": "application/json" });
+            res.end(JSON.stringify({ status: "ok", service: "markdown-new-mcp" }));
+            return;
+        }
+        if (req.method === "GET" && req.url === "/sse") {
+            const server = createServer();
+            const transport = new SSEServerTransport("/message", res);
+            await server.connect(transport);
+            return;
+        }
+        if (req.method === "POST" && req.url === "/message") {
+            let body = "";
+            req.on("data", (chunk) => {
+                body += chunk.toString();
+            });
+            req.on("end", () => {
+                res.writeHead(200, { "Content-Type": "application/json" });
+                res.end(JSON.stringify({ received: true }));
+            });
+            return;
+        }
+        res.writeHead(404);
+        res.end("Not Found");
+    });
+    return new Promise((resolve) => {
+        httpServer.listen(port, "0.0.0.0", () => {
+            console.log(`MCP SSE Server running on http://0.0.0.0:${port}`);
+            console.log(`Health check: http://0.0.0.0:${port}/health`);
+            console.log(`SSE endpoint: http://0.0.0.0:${port}/sse`);
+            resolve();
+        });
+    });
+}
+async function main() {
+    const mode = process.env.MCP_TRANSPORT || "stdio";
+    const port = parseInt(process.env.MCP_PORT || "38721", 10);
+    if (mode === "sse") {
+        await runSSE(port);
+    }
+    else {
+        await runStdio();
+    }
+}
+main().catch((error) => {
+    console.error("Fatal error in main():", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "markdown-new-mcp",
+  "version": "1.0.0",
+  "description": "MCP server for markdown.new file conversion API - convert PDF, DOCX, XLSX, images and 20+ formats to Markdown",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "markdown-new-mcp": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts",
+    "prepare": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "markdown",
+    "file-conversion",
+    "pdf-to-markdown",
+    "docx-to-markdown",
+    "xlsx-to-markdown"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.0",
+    "zod": "^3.22.4"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.24",
+    "typescript": "^5.3.3",
+    "tsx": "^4.7.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/src/index.ts

@@ -0,0 +1,327 @@
+#!/usr/bin/env node
+
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { SSEServerTransport } from "@modelcontextprotocol/sdk/server/sse.js";
+import { z } from "zod";
+import fs from "fs/promises";
+import path from "path";
+import { statSync } from "fs";
+import http from "http";
+
+const MARKDOWN_NEW_BASE_URL = "https://markdown.new";
+
+interface MarkdownResponse {
+  markdown?: string;
+  content?: string;
+  title?: string;
+  tokens?: number;
+  duration?: number;
+  [key: string]: unknown;
+}
+
+function extractMarkdown(data: unknown): string {
+  if (typeof data === "string") {
+    return data;
+  }
+  if (typeof data === "object" && data !== null) {
+    const obj = data as MarkdownResponse;
+    if (typeof obj.markdown === "string") {
+      return obj.markdown;
+    }
+    if (typeof obj.content === "string") {
+      return obj.content;
+    }
+  }
+  return JSON.stringify(data, null, 2);
+}
+
+function createServer(): McpServer {
+  const server = new McpServer({
+    name: "markdown-new-mcp",
+    version: "1.0.0",
+  });
+
+  server.tool(
+    "convert_url_to_markdown",
+    "Convert a remote file URL to Markdown. Supports PDF, DOCX, XLSX, images and 20+ formats. Maximum file size: 10MB.",
+    {
+      url: z.string().url().describe("The URL of the remote file to convert"),
+      api_key: z.string().optional().describe("Optional API key for higher rate limits (format: mk_...)"),
+    },
+    async ({ url, api_key }) => {
+      try {
+        const headers: Record<string, string> = {
+          "Content-Type": "application/json",
+        };
+
+        if (api_key) {
+          headers["Authorization"] = `Bearer ${api_key}`;
+        }
+
+        const response = await fetch(MARKDOWN_NEW_BASE_URL, {
+          method: "POST",
+          headers,
+          body: JSON.stringify({ url }),
+        });
+
+        if (!response.ok) {
+          const errorText = await response.text();
+          return {
+            content: [
+              {
+                type: "text" as const,
+                text: `Error converting URL: ${response.status} ${response.statusText}\n${errorText}`,
+              },
+            ],
+            isError: true,
+          };
+        }
+
+        const data = await response.json();
+        const markdown = extractMarkdown(data);
+
+        return {
+          content: [
+            {
+              type: "text" as const,
+              text: markdown,
+            },
+          ],
+        };
+      } catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+          content: [
+            {
+              type: "text" as const,
+              text: `Failed to convert URL to Markdown: ${errorMessage}`,
+            },
+          ],
+          isError: true,
+        };
+      }
+    }
+  );
+
+  server.tool(
+    "convert_file_to_markdown",
+    "Convert a local file to Markdown. Supports PDF, DOCX, XLSX, images and 20+ formats. Maximum file size: 10MB.",
+    {
+      file_path: z.string().describe("The absolute path to the local file to convert"),
+      api_key: z.string().optional().describe("Optional API key for higher rate limits (format: mk_...)"),
+    },
+    async ({ file_path, api_key }) => {
+      try {
+        let fileStats;
+        try {
+          fileStats = statSync(file_path);
+        } catch {
+          return {
+            content: [
+              {
+                type: "text" as const,
+                text: `File not found: ${file_path}`,
+              },
+            ],
+            isError: true,
+          };
+        }
+
+        const MAX_FILE_SIZE = 10 * 1024 * 1024;
+        if (fileStats.size > MAX_FILE_SIZE) {
+          return {
+            content: [
+              {
+                type: "text" as const,
+                text: `File too large: ${file_path} (${(fileStats.size / 1024 / 1024).toFixed(2)}MB). Maximum size is 10MB.`,
+              },
+            ],
+            isError: true,
+          };
+        }
+
+        const fileContent = await fs.readFile(file_path);
+        const fileName = path.basename(file_path);
+
+        const formData = new FormData();
+        const blob = new Blob([fileContent]);
+        formData.append("file", blob, fileName);
+
+        const headers: Record<string, string> = {};
+
+        if (api_key) {
+          headers["Authorization"] = `Bearer ${api_key}`;
+        }
+
+        const response = await fetch(`${MARKDOWN_NEW_BASE_URL}/convert`, {
+          method: "POST",
+          headers,
+          body: formData,
+        });
+
+        if (!response.ok) {
+          const errorText = await response.text();
+          return {
+            content: [
+              {
+                type: "text" as const,
+                text: `Error converting file: ${response.status} ${response.statusText}\n${errorText}`,
+              },
+            ],
+            isError: true,
+          };
+        }
+
+        const data = await response.json();
+        const markdown = extractMarkdown(data);
+
+        return {
+          content: [
+            {
+              type: "text" as const,
+              text: markdown,
+            },
+          ],
+        };
+      } catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+          content: [
+            {
+              type: "text" as const,
+              text: `Failed to convert file to Markdown: ${errorMessage}`,
+            },
+          ],
+          isError: true,
+        };
+      }
+    }
+  );
+
+  server.tool(
+    "convert_url_to_json",
+    "Convert a remote file URL to JSON with metadata (title, tokens, duration, etc). Supports PDF, DOCX, XLSX, images and 20+ formats.",
+    {
+      url: z.string().url().describe("The URL of the remote file to convert"),
+      api_key: z.string().optional().describe("Optional API key for higher rate limits (format: mk_...)"),
+    },
+    async ({ url, api_key }) => {
+      try {
+        const encodedUrl = encodeURIComponent(url);
+        const requestUrl = `${MARKDOWN_NEW_BASE_URL}/${encodedUrl}?format=json`;
+
+        const headers: Record<string, string> = {};
+
+        if (api_key) {
+          headers["Authorization"] = `Bearer ${api_key}`;
+        }
+
+        const response = await fetch(requestUrl, {
+          method: "GET",
+          headers,
+        });
+
+        if (!response.ok) {
+          const errorText = await response.text();
+          return {
+            content: [
+              {
+                type: "text" as const,
+                text: `Error converting URL: ${response.status} ${response.statusText}\n${errorText}`,
+              },
+            ],
+            isError: true,
+          };
+        }
+
+        const data = await response.json();
+
+        return {
+          content: [
+            {
+              type: "text" as const,
+              text: JSON.stringify(data, null, 2),
+            },
+          ],
+        };
+      } catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+          content: [
+            {
+              type: "text" as const,
+              text: `Failed to convert URL to JSON: ${errorMessage}`,
+            },
+          ],
+          isError: true,
+        };
+      }
+    }
+  );
+
+  return server;
+}
+
+async function runStdio() {
+  const server = createServer();
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+}
+
+async function runSSE(port: number) {
+  const httpServer = http.createServer(async (req, res) => {
+    if (req.method === "GET" && req.url === "/health") {
+      res.writeHead(200, { "Content-Type": "application/json" });
+      res.end(JSON.stringify({ status: "ok", service: "markdown-new-mcp" }));
+      return;
+    }
+
+    if (req.method === "GET" && req.url === "/sse") {
+      const server = createServer();
+      const transport = new SSEServerTransport("/message", res);
+      await server.connect(transport);
+      return;
+    }
+
+    if (req.method === "POST" && req.url === "/message") {
+      let body = "";
+      req.on("data", (chunk) => {
+        body += chunk.toString();
+      });
+      req.on("end", () => {
+        res.writeHead(200, { "Content-Type": "application/json" });
+        res.end(JSON.stringify({ received: true }));
+      });
+      return;
+    }
+
+    res.writeHead(404);
+    res.end("Not Found");
+  });
+
+  return new Promise<void>((resolve) => {
+    httpServer.listen(port, "0.0.0.0", () => {
+      console.log(`MCP SSE Server running on http://0.0.0.0:${port}`);
+      console.log(`Health check: http://0.0.0.0:${port}/health`);
+      console.log(`SSE endpoint: http://0.0.0.0:${port}/sse`);
+      resolve();
+    });
+  });
+}
+
+async function main() {
+  const mode = process.env.MCP_TRANSPORT || "stdio";
+  const port = parseInt(process.env.MCP_PORT || "38721", 10);
+
+  if (mode === "sse") {
+    await runSSE(port);
+  } else {
+    await runStdio();
+  }
+}
+
+main().catch((error) => {
+  console.error("Fatal error in main():", error);
+  process.exit(1);
+});

package/tsconfig.json

@@ -0,0 +1,20 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "lib": ["ES2022"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "resolveJsonModule": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}