mcp-word 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,120 @@
+#!/usr/bin/env node
+// src/index.ts
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, ErrorCode, McpError, } from "@modelcontextprotocol/sdk/types.js";
+import { z } from "zod";
+import { promises as fs } from "fs";
+import path from "path";
+import { convertMarkdownToDocx } from "@mohtasham/md-to-docx";
+// ============================================
+// Schema 定義（使用 Zod 進行驗證）
+// ============================================
+const MarkdownToDocxSchema = z.object({
+    markdown: z.string().describe("要轉換的 Markdown 文字內容"),
+    filePath: z.string().describe("要儲存的檔案路徑（包含檔名，例如：/path/to/file.docx）"),
+    useGovernmentFormat: z.boolean().optional().default(false).describe("是否套用政府報告書格式（標題字體大小：H1=18pt, H2=14pt, H3=12pt）"),
+});
+// ============================================
+// Server 初始化
+// ============================================
+const server = new Server({
+    name: "mcp-word",
+    version: "1.0.0",
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+// ============================================
+// Tools 處理
+// ============================================
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return {
+        tools: [
+            {
+                name: "markdown_to_docx",
+                description: "將 Markdown 文字轉換為 DOCX 檔案並儲存到指定路徑。支援政府報告書格式（3層標題結構：壹、一、(一)），可選擇是否套用政府報告字體大小規範。",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        markdown: {
+                            type: "string",
+                            description: "要轉換的 Markdown 文字內容。支援政府報告書格式：第1層 # 壹、貳、叁...（18pt），第2層 ## 一、二、三...（14pt），第3層 ### (一)、(二)、(三)...（12pt）。僅使用3層標題，避免使用 #### ##### ######。"
+                        },
+                        filePath: {
+                            type: "string",
+                            description: "要儲存的檔案路徑（包含檔名，例如：/path/to/file.docx）"
+                        },
+                        useGovernmentFormat: {
+                            type: "boolean",
+                            description: "是否套用政府報告書格式樣式（標題字體大小：H1=18pt, H2=14pt, H3=12pt）。預設為 false。",
+                            default: false
+                        },
+                    },
+                    required: ["markdown", "filePath"],
+                },
+            },
+        ],
+    };
+});
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    try {
+        switch (name) {
+            case "markdown_to_docx": {
+                const validated = MarkdownToDocxSchema.parse(args);
+                // 確保目錄存在
+                const dir = path.dirname(validated.filePath);
+                await fs.mkdir(dir, { recursive: true });
+                // 準備樣式設定
+                const styleOptions = {
+                    tableLayout: "fixed", // 使用固定寬度模式，表格會填滿頁面寬度，欄位平均分配
+                };
+                // 如果啟用政府報告格式，套用對應的字體大小
+                if (validated.useGovernmentFormat) {
+                    styleOptions.heading1Size = 18; // 第1層標題：18pt
+                    styleOptions.heading2Size = 14; // 第2層標題：14pt
+                    styleOptions.heading3Size = 12; // 第3層標題：12pt
+                    styleOptions.paragraphSize = 12; // 段落：12pt
+                }
+                // 轉換 Markdown 為 DOCX
+                const docxBlob = await convertMarkdownToDocx(validated.markdown, {
+                    style: styleOptions,
+                });
+                // 將 Blob 轉換為 Buffer 並寫入檔案
+                const arrayBuffer = await docxBlob.arrayBuffer();
+                const buffer = Buffer.from(arrayBuffer);
+                await fs.writeFile(validated.filePath, buffer);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `檔案已成功轉換並儲存至：${validated.filePath}`,
+                        },
+                    ],
+                };
+            }
+            default:
+                throw new McpError(ErrorCode.MethodNotFound, `Unknown tool: ${name}`);
+        }
+    }
+    catch (error) {
+        if (error instanceof z.ZodError) {
+            throw new McpError(ErrorCode.InvalidParams, `Invalid parameters: ${error.issues.map((e) => e.message).join(", ")}`);
+        }
+        throw error;
+    }
+});
+// ============================================
+// Server 啟動
+// ============================================
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("MCP Word Server started");
+}
+main().catch((error) => {
+    console.error("Fatal error:", error);
+    process.exit(1);
+});

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "mcp-word",
+  "version": "1.0.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "mcp-word": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsc --watch",
+    "inspect": "npx @modelcontextprotocol/inspector node dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.25.2",
+    "@mohtasham/md-to-docx": "^2.6.0",
+    "zod": "^4.3.5"
+  },
+  "devDependencies": {
+    "@types/node": "^25.0.7",
+    "typescript": "^5.9.3"
+  }
+}