@developer.k/ms-office-mcp 1.0.0

package/build/tools/word.js

@@ -0,0 +1,206 @@
+import { createRequire } from "node:module";
+import fs from "node:fs";
+import path from "node:path";
+import { ErrorCode, McpError } from "@modelcontextprotocol/sdk/types.js";
+import { z } from "zod";
+import { runPowerShell, textContent, toBase64 } from "../office-utils.js";
+const require = createRequire(import.meta.url);
+const mammoth = require("mammoth");
+const { Document, Packer, Paragraph, TextRun } = require("docx");
+const ReadWordSchema = z.object({
+    path: z.string().describe("Path to the Word file (.docx)"),
+});
+const WriteWordSchema = z.object({
+    path: z.string().describe("Path to the Word file (.docx)"),
+    title: z.string().optional().describe("Document title"),
+    content: z.string().describe("Text content to write to the document"),
+});
+const GetActiveOfficeSchema = z.object({
+    filename: z.string().optional().describe("Name of the specific file to get data from. If omitted, the active document is used."),
+});
+const WriteActiveWordSchema = z.object({
+    filename: z.string().optional().describe("Name of the document. If omitted, the active document is used."),
+    operation: z.enum(["append", "replace_text", "replace_all"]).describe("How to edit the active Word document"),
+    text: z.string().describe("Text to insert or use as replacement content"),
+    findText: z.string().optional().describe("Text to find when operation is replace_text"),
+    replaceAllMatches: z.boolean().optional().default(false).describe("Replace every match instead of only the first match"),
+});
+export const wordTools = {
+    tools: [
+        {
+            name: "read_word",
+            description: "Read text content from a Word file (.docx)",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    path: { type: "string", description: "Path to the Word file" },
+                },
+                required: ["path"],
+            },
+        },
+        {
+            name: "write_word",
+            description: "Create a new Word file with text content",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    path: { type: "string", description: "Path to the Word file" },
+                    title: { type: "string", description: "Document title (optional)" },
+                    content: { type: "string", description: "Text content" },
+                },
+                required: ["path", "content"],
+            },
+        },
+        {
+            name: "list_active_word",
+            description: "List all open Word documents",
+            inputSchema: {
+                type: "object",
+                properties: {},
+            },
+        },
+        {
+            name: "get_active_word",
+            description: "Get text content from a currently open (active) Word document without saving",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    filename: { type: "string", description: "Name of the document (e.g., 'Document1.docx'). If omitted, the active document is used." },
+                },
+            },
+        },
+        {
+            name: "write_active_word",
+            description: "Edit a currently open Word document without saving. Supports append, replace_text, and replace_all.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    filename: { type: "string", description: "Name of the document (e.g., 'Document1.docx'). If omitted, the active document is used." },
+                    operation: {
+                        type: "string",
+                        enum: ["append", "replace_text", "replace_all"],
+                        description: "append adds text to the end, replace_text replaces matching text, replace_all replaces the whole document body",
+                    },
+                    text: { type: "string", description: "Text to insert or use as replacement content" },
+                    findText: { type: "string", description: "Text to find when operation is replace_text" },
+                    replaceAllMatches: { type: "boolean", description: "Replace every match instead of only the first match" },
+                },
+                required: ["operation", "text"],
+            },
+        },
+    ],
+    handlers: {
+        async read_word(args) {
+            const { path: filePath } = ReadWordSchema.parse(args);
+            const absolutePath = path.resolve(filePath);
+            if (!fs.existsSync(absolutePath)) {
+                throw new McpError(ErrorCode.InvalidParams, `File not found: ${filePath}`);
+            }
+            const result = await mammoth.extractRawText({ path: absolutePath });
+            return textContent(result.value);
+        },
+        async write_word(args) {
+            const { path: filePath, title, content } = WriteWordSchema.parse(args);
+            const absolutePath = path.resolve(filePath);
+            const doc = new Document({
+                sections: [{
+                        properties: {},
+                        children: [
+                            ...(title ? [new Paragraph({
+                                    children: [new TextRun({
+                                            text: title,
+                                            bold: true,
+                                            size: 32,
+                                            font: "Malgun Gothic",
+                                        })],
+                                    spacing: { after: 400 },
+                                })] : []),
+                            ...content.split("\n").map(line => new Paragraph({
+                                children: [new TextRun({
+                                        text: line,
+                                        font: "Malgun Gothic",
+                                    })],
+                            })),
+                        ],
+                    }],
+            });
+            const buffer = await Packer.toBuffer(doc);
+            fs.writeFileSync(absolutePath, buffer);
+            return textContent(`Successfully created Word file at ${filePath}`);
+        },
+        async list_active_word() {
+            const script = `
+        $word = [Runtime.InteropServices.Marshal]::GetActiveObject('Word.Application')
+        $names = @($word.Documents | ForEach-Object { $_.Name })
+        ConvertTo-Json -InputObject @($names) -Compress
+      `;
+            return textContent(runPowerShell(script));
+        },
+        async get_active_word(args) {
+            const { filename } = GetActiveOfficeSchema.parse(args);
+            const script = `
+        $word = [Runtime.InteropServices.Marshal]::GetActiveObject('Word.Application')
+        $target = "${filename || ""}"
+        $doc = if ($target) {
+            $word.Documents | Where-Object { $_.Name -eq $target -or $_.FullName -eq $target } | Select-Object -First 1
+        } else {
+            $word.ActiveDocument
+        }
+        if ($null -eq $doc) { throw "Document '$target' not found or no active document." }
+        $doc.Content.Text
+      `;
+            return textContent(runPowerShell(script));
+        },
+        async write_active_word(args) {
+            const { filename, operation, text, findText, replaceAllMatches } = WriteActiveWordSchema.parse(args);
+            if (operation === "replace_text" && !findText) {
+                throw new McpError(ErrorCode.InvalidParams, "findText is required when operation is replace_text.");
+            }
+            const filenameBase64 = toBase64(filename || "");
+            const textBase64 = toBase64(text);
+            const findTextBase64 = toBase64(findText || "");
+            const script = `
+        function Decode-Utf8([string]$value) {
+          [System.Text.Encoding]::UTF8.GetString([System.Convert]::FromBase64String($value))
+        }
+
+        $word = [Runtime.InteropServices.Marshal]::GetActiveObject('Word.Application')
+        $target = Decode-Utf8 '${filenameBase64}'
+        $operation = '${operation}'
+        $text = Decode-Utf8 '${textBase64}'
+        $findText = Decode-Utf8 '${findTextBase64}'
+        $replaceAllMatches = [System.Convert]::ToBoolean('${replaceAllMatches}')
+
+        $doc = if ($target) {
+            $word.Documents | Where-Object { $_.Name -eq $target -or $_.FullName -eq $target } | Select-Object -First 1
+        } else {
+            $word.ActiveDocument
+        }
+        if ($null -eq $doc) { throw "Document '$target' not found or no active document." }
+
+        if ($operation -eq 'append') {
+            $range = $doc.Content
+            $range.Collapse(0)
+            $range.InsertAfter([Environment]::NewLine + $text)
+            $result = @{ Document = $doc.Name; Operation = $operation; Changed = 1 }
+        } elseif ($operation -eq 'replace_all') {
+            $doc.Content.Text = $text
+            $result = @{ Document = $doc.Name; Operation = $operation; Changed = 1 }
+        } elseif ($operation -eq 'replace_text') {
+            $range = $doc.Content
+            $find = $range.Find
+            $find.ClearFormatting()
+            $find.Replacement.ClearFormatting()
+            $replaceMode = if ($replaceAllMatches) { 2 } else { 1 }
+            $changed = $find.Execute($findText, $false, $false, $false, $false, $false, $true, 1, $false, $text, $replaceMode)
+            $result = @{ Document = $doc.Name; Operation = $operation; Changed = [int][bool]$changed; ReplacedAllMatches = $replaceAllMatches }
+        } else {
+            throw "Unsupported Word operation: $operation"
+        }
+
+        ConvertTo-Json -InputObject $result -Compress
+      `;
+            return textContent(runPowerShell(script));
+        },
+    },
+};

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@developer.k/ms-office-mcp",
+  "version": "1.0.0",
+  "description": "MCP server for local Microsoft Office files and active desktop Office documents",
+  "type": "module",
+  "main": "build/index.js",
+  "bin": {
+    "ms-office-mcp": "build/index.js"
+  },
+  "files": [
+    "build",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepack": "npm run build",
+    "start": "node build/index.js",
+    "dev": "ts-node --esm src/index.ts"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "office",
+    "excel",
+    "word",
+    "powerpoint"
+  ],
+  "author": "",
+  "license": "ISC",
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "docx": "^9.7.1",
+    "mammoth": "^1.12.0",
+    "officeparser": "^7.2.1",
+    "pptxgenjs": "^4.0.1",
+    "xlsx": "^0.18.5",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@types/node": "^25.9.3",
+    "ts-node": "^10.9.2",
+    "typescript": "^6.0.3"
+  }
+}