word-generator-mcp 1.0.0

package/README.md

@@ -0,0 +1,158 @@
+# word-generator-mcp
+
+Word文档生成 MCP Server，实现以下目标：
+
+1. 读取并理解skills的规范
+2. 根据规范生成对应的Node.js脚本（不保存到本地）
+3. 执行Node.js脚本，生成对应的Word文档
+
+## 功能
+
+### 工具列表
+
+| 工具名称 | 功能描述 |
+|---------|---------|
+| `list_skills` | 列出所有可用的skills（读取.kilocode/skills目录） |
+| `read_skill` | 读取指定skill的SKILL.md文件内容 |
+| `generate_word_script` | 根据skill规范生成Node.js Word生成脚本（返回脚本内容，不保存） |
+| `generate_word_document` | 根据skill规范和报告数据直接生成Word文档 |
+
+### Word格式规范
+
+根据 `.kilocode/skills/word-format-common/SKILL.md` 规范：
+
+- **标题颜色**：全部黑色（RGB 0,0,0）
+- **标题字体**：全部黑体（Heiti/SimHei）
+- **主标题**：居中，黑体，22pt
+- **一级标题**：黑体，18pt
+- **二/三级标题**：黑体，16pt
+- **正文字体**：仿宋
+- **首行缩进**：2字符
+- **观点标红**：框架建议与观点性内容使用红色加粗
+
+## 安装
+
+```bash
+cd scripts/word-generator-mcp
+npm install
+```
+
+## 在MCP客户端中配置
+
+### 方式一：npx（推荐）
+
+```json
+{
+  "word-generator": {
+    "command": "npx",
+    "args": ["-y", "file:./scripts/word-generator-mcp"],
+    "alwaysAllow": ["*"]
+  }
+}
+```
+
+### 方式二：本地安装后直接运行
+
+```json
+{
+  "word-generator": {
+    "command": "node",
+    "args": ["scripts/word-generator-mcp/server.js"],
+    "alwaysAllow": ["*"]
+  }
+}
+```
+
+## 使用示例
+
+### 1. 列出所有skills
+
+```json
+{
+  "name": "list_skills",
+  "arguments": {}
+}
+```
+
+### 2. 读取指定skill
+
+```json
+{
+  "name": "read_skill",
+  "arguments": {
+    "skill_name": "word-format-common"
+  }
+}
+```
+
+### 3. 生成Word文档
+
+```json
+{
+  "name": "generate_word_document",
+  "arguments": {
+    "skill_name": "sentiment-writer",
+    "report_data": {
+      "title": "舆情分析报告",
+      "opening": "本报告旨在分析...",
+      "sections": [
+        {
+          "heading": "一、事件概述",
+          "subsections": [
+            {
+              "heading": "（一）背景",
+              "paragraphs": [
+                { "text": "这是正文内容..." },
+                { "text": "这是观点性内容（红色加粗）", "isViewPoint": true }
+              ]
+            }
+          ]
+        }
+      ],
+      "references": [
+        "【1】来源链接..."
+      ]
+    }
+  }
+}
+```
+
+## 报告数据结构
+
+```typescript
+interface ReportData {
+  title: string;                    // 报告标题
+  opening?: string;                 // 开篇段落
+  sections: Section[];              // 各节内容
+  references?: string[];            // 参考文献
+}
+
+interface Section {
+  heading: string;                  // 一级标题（如：一、事件概述）
+  subsections?: Subsection[];       // 二级内容
+  paragraphs?: Paragraph[];         // 直接段落
+}
+
+interface Subsection {
+  heading: string;                  // 二级标题（如：（一）背景）
+  paragraphs: Paragraph[];          // 段落列表
+}
+
+interface Paragraph {
+  text: string;                     // 段落文本
+  isViewPoint?: boolean;            // 是否为观点性内容（红色加粗）
+}
+```
+
+## 输出
+
+- 生成的Word文档保存在 `word/` 目录
+- 文件名格式：`{标题}_{时间戳}.docx`
+
+## 要求
+
+- Node.js >= 18
+
+## License
+
+MIT

package/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "word-generator-mcp",
+  "version": "1.0.0",
+  "description": "MCP server：根据 report_data 生成 Word 报告/简报，保存到当前工作目录（项目根）",
+  "type": "module",
+  "main": "server.js",
+  "bin": {
+    "word-generator-mcp": "server.js"
+  },
+  "scripts": { "start": "node server.js" },
+  "keywords": ["mcp", "word", "docx", "report", "briefing", "model-context-protocol"],
+  "license": "MIT",
+  "engines": { "node": ">=18" },
+  "files": ["server.js"],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "ajv": "^8.17.1",
+    "ajv-formats": "^3.0.1",
+    "docx": "^8.5.0"
+  }
+}

package/server.js

@@ -0,0 +1,249 @@
+#!/usr/bin/env node
+/**
+ * Word Generator MCP Server
+ * 功能：根据 report_data 一键生成 Word 报告/简报，保存到 word/ 目录。
+ */
+
+import { Server } from "@modelcontextprotocol/sdk/server";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import {
+  ListToolsRequestSchema,
+  CallToolRequestSchema,
+} from "@modelcontextprotocol/sdk/types.js";
+import { Document, Packer, Paragraph, TextRun, AlignmentType, HeadingLevel } from "docx";
+import * as fs from "fs";
+import * as path from "path";
+import { fileURLToPath } from "url";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+// 保存目录：npx 或本地运行时均使用当前工作目录（用户项目根），便于其他电脑直接 npx 调用
+const WORD_DIR = process.cwd();
+
+// 所有标题字体颜色均为黑色；正文黑色，仅观点性内容（isViewPoint）为红色；标题一居中，其余标题居左
+const WORD_CONFIG = {
+  title: { font: "黑体", size: 44, color: "000000", bold: true },
+  heading1: { font: "黑体", size: 36, color: "000000", bold: true },
+  heading2: { font: "黑体", size: 32, color: "000000", bold: true },
+  body: { font: "仿宋", size: 28, color: "000000" },
+  viewPoint: { font: "仿宋", size: 28, color: "C00000", bold: true }
+};
+
+function createTextRun(text, style) {
+  return new TextRun({
+    text: text || "",
+    font: style.font,
+    size: style.size,
+    bold: style.bold || false,
+    color: style.color
+  });
+}
+
+// 数字转中文大写（一、二、三、四、五…），用于「数据来源与参考文献」等标题编号
+const CHINESE_NUMBERS = ["零", "一", "二", "三", "四", "五", "六", "七", "八", "九", "十"];
+function toChineseNumber(n) {
+  if (n <= 0 || n > 99) return String(n);
+  if (n <= 10) return CHINESE_NUMBERS[n];
+  if (n < 20) return "十" + CHINESE_NUMBERS[n - 10];
+  if (n < 100) {
+    const tens = Math.floor(n / 10);
+    const ones = n % 10;
+    return CHINESE_NUMBERS[tens] + "十" + (ones > 0 ? CHINESE_NUMBERS[ones] : "");
+  }
+  return String(n);
+}
+
+async function generateWordDocument(reportData) {
+  const children = [];
+
+  if (reportData.title) {
+    children.push(new Paragraph({
+      alignment: AlignmentType.CENTER,
+      heading: HeadingLevel.TITLE,
+      children: [createTextRun(reportData.title, WORD_CONFIG.title)]
+    }));
+    children.push(new Paragraph({ children: [] }));
+  }
+
+  if (reportData.opening) {
+    children.push(new Paragraph({
+      alignment: AlignmentType.START,
+      indent: { firstLine: 560 },
+      children: [createTextRun(reportData.opening, WORD_CONFIG.body)]
+    }));
+    children.push(new Paragraph({ children: [] }));
+  }
+
+  if (reportData.sections && Array.isArray(reportData.sections)) {
+    for (const section of reportData.sections) {
+      if (section.heading) {
+        children.push(new Paragraph({
+          alignment: AlignmentType.START,
+          heading: HeadingLevel.HEADING_1,
+          children: [createTextRun(section.heading, WORD_CONFIG.heading1)]
+        }));
+      }
+
+      if (section.subsections && Array.isArray(section.subsections)) {
+        for (const sub of section.subsections) {
+          if (sub.heading) {
+            children.push(new Paragraph({
+              alignment: AlignmentType.START,
+              heading: HeadingLevel.HEADING_2,
+              children: [createTextRun(sub.heading, WORD_CONFIG.heading2)]
+            }));
+          }
+          if (sub.paragraphs && Array.isArray(sub.paragraphs)) {
+            for (const para of sub.paragraphs) {
+              const text = typeof para === 'string' ? para : (para.text || '');
+              const isViewPoint = typeof para === 'object' && para.isViewPoint;
+              const style = isViewPoint ? WORD_CONFIG.viewPoint : WORD_CONFIG.body;
+              children.push(new Paragraph({
+                alignment: AlignmentType.START,
+                indent: { firstLine: 560 },
+                children: [createTextRun(text, style)]
+              }));
+            }
+          }
+        }
+      }
+
+      if (section.paragraphs && Array.isArray(section.paragraphs)) {
+        for (const para of section.paragraphs) {
+          const text = typeof para === 'string' ? para : (para.text || '');
+          const isViewPoint = typeof para === 'object' && para.isViewPoint;
+          const style = isViewPoint ? WORD_CONFIG.viewPoint : WORD_CONFIG.body;
+          children.push(new Paragraph({
+            alignment: AlignmentType.START,
+            indent: { firstLine: 560 },
+            children: [createTextRun(text, style)]
+          }));
+        }
+      }
+    }
+  }
+
+  if (reportData.references && Array.isArray(reportData.references) && reportData.references.length > 0) {
+    const sectionCount = reportData.sections ? reportData.sections.length : 0;
+    const refHeadingNum = sectionCount + 1;
+    const refHeadingText = `${toChineseNumber(refHeadingNum)}、数据来源与参考文献`;
+    children.push(new Paragraph({
+      alignment: AlignmentType.START,
+      heading: HeadingLevel.HEADING_1,
+      children: [createTextRun(refHeadingText, WORD_CONFIG.heading1)]
+    }));
+    for (const ref of reportData.references) {
+      const refText = typeof ref === 'string' ? ref : String(ref);
+      children.push(new Paragraph({
+        alignment: AlignmentType.START,
+        indent: { firstLine: 560 },
+        children: [createTextRun(refText, { ...WORD_CONFIG.body, size: 24 })]
+      }));
+    }
+  }
+
+  const doc = new Document({
+    numbering: {
+      config: [{
+        reference: "default-numbering",
+        levels: [{ level: 0, format: "decimal", text: "%1.", alignment: AlignmentType.START }]
+      }]
+    },
+    sections: [{
+      properties: {
+        page: { margin: { top: 1440, right: 1440, bottom: 1440, left: 1440 } }
+      },
+      children: children
+    }]
+  });
+
+  const buffer = await Packer.toBuffer(doc);
+  const timestamp = new Date().toISOString().replace(/[:.]/g, "-").slice(0, 19);
+  const safeTitle = (reportData.title || "报告").replace(/[\\/:*?"<>|]/g, "_");
+  const filename = `${safeTitle}_${timestamp}.docx`;
+  const filepath = path.join(WORD_DIR, filename);
+  fs.writeFileSync(filepath, buffer);
+  return { success: true, filepath: filepath, size: buffer.length };
+}
+
+const server = new Server(
+  { name: "word-generator-mcp", version: "2.0.0" },
+  { capabilities: { tools: {} } }
+);
+
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+  return {
+    tools: [{
+      name: "generate_word_document",
+      description: "根据报告数据直接生成Word文档（保存到项目根目录）。参数：skill_name（可选）, report_data（必需，包含title、opening、sections、references）",
+      inputSchema: {
+        type: "object",
+        properties: {
+          skill_name: { type: "string", description: "skill名称（可选，如 sentiment-writer / briefing-writer）" },
+          report_data: {
+            type: "object",
+            description: "报告数据：title、opening、sections（每节含heading、subsections或paragraphs；paragraphs项可含 isViewPoint: true 表示红加粗）、references（字符串数组）"
+          }
+        },
+        required: ["report_data"]
+      }
+    }]
+  };
+});
+
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  try {
+    const toolName = request.params.name;
+    const args = request.params.arguments || {};
+    if (toolName === "generate_word_document") {
+      const reportData = args.report_data;
+      if (!reportData) {
+        return {
+          content: [{ type: "text", text: JSON.stringify({ success: false, error: "缺少report_data参数" }) }],
+          isError: true
+        };
+      }
+      try {
+        const result = await generateWordDocument(reportData);
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      } catch (err) {
+        return {
+          content: [{ type: "text", text: JSON.stringify({ success: false, error: err.message, stack: err.stack }) }],
+          isError: true
+        };
+      }
+    }
+    return {
+      content: [{ type: "text", text: JSON.stringify({ error: "Unknown tool: " + toolName }) }],
+      isError: true
+    };
+  } catch (err) {
+    const msg = (err && err.message) || String(err);
+    return {
+      content: [{ type: "text", text: JSON.stringify({ error: msg }, null, 2) }],
+      isError: true
+    };
+  }
+});
+
+function logErr(...args) {
+  const msg = args.map((a) => (typeof a === "object" ? JSON.stringify(a) : String(a))).join(" ");
+  if (typeof process !== "undefined" && process.stderr && process.stderr.write) {
+    process.stderr.write("[word-generator-mcp] " + msg + "\n");
+  }
+}
+process.on("uncaughtException", (err) => {
+  logErr("uncaughtException:", err && err.message, err && err.stack);
+});
+process.on("unhandledRejection", (reason) => {
+  logErr("unhandledRejection:", reason);
+});
+
+const transport = new StdioServerTransport();
+try {
+  await server.connect(transport);
+} catch (err) {
+  logErr("server.connect failed:", err && err.message, err && err.stack);
+  process.exitCode = 1;
+}