Generate Pdf And Word

Document Generator MCP

一个 MCP（Model Context Protocol）服务，可通过任何支持 MCP 的 AI Agent（包括 Claude Desktop、Amazon Q Developer、Cline、Continue 等）生成专业的 Word（.docx）和 PDF 文档。

🚀 功能

• ✅ 生成 Word 文档（.docx）
• ✅ 生成 PDF 文档
• ✅ 自动检测 JSON 块（无需反引号！）🆕
• ✅ 专业语法高亮（VS Code Dark 主题）
• ✅ 智能分页（页面之间不会截断内容）
• ✅ 100% 响应式排版（遵循 A4 页边距）
• ✅ 支持 Markdown（标题、列表、粗体、斜体、代码块）
• ✅ 自动进行专业排版
• ✅ 元数据（作者、创建日期）

📦 安装

通过 NPX（推荐）

npx document-generator-mcp@latest

通过 NPM 全局安装

npm install -g document-generator-mcp

⚙️ 配置

Claude Desktop

1. 找到配置文件：

   • Linux： ~/.config/claude-desktop/claude_desktop_config.json
   • macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows： %APPDATA%\Claude\claude_desktop_config.json

2. 添加此配置：

{
  "mcpServers": {
    "document-generator": {
      "command": "npx",
      "args": ["--yes", "--cache", "/tmp/.npx-cache", "document-generator-mcp@latest"]
    }
  }
}

3. 重启 Claude Desktop

Amazon Q Developer

1. 使用 Amazon Q 扩展打开 VS Code
2. 进入 Amazon Q 设置
3. 添加 MCP 服务：

{
  "mcpServers": {
    "document-generator": {
      "command": "npx",
      "args": ["--yes", "--cache", "/tmp/.npx-cache", "document-generator-mcp@latest"]
    }
  }
}

其他 MCP Agent（Cline、Continue 等）

对于其他支持 MCP 的 Agent，请添加服务配置：

{
  "name": "document-generator",
  "command": "npx",
  "args": ["--yes", "--cache", "/tmp/.npx-cache", "document-generator-mcp@latest"]
}

请查阅相应 Agent 的文档，了解配置详情。

🎯 使用方法

配置完成后，你可以在任何 MCP Agent 中使用自然语言指令：

提示词示例

• “创建一份关于销售分析的 Word 文档”
• “生成一份关于该项目的 PDF 报告”
• “制作一份 Word 和 PDF 格式的技术手册”
• “创建 Word 格式的 API 文档”
• “为这段 JavaScript 代码编写文档并附上示例”

可用工具

• gerar_documento_word：创建 Word 文档、PDF 或两者兼有
• gerar_documento_pdf：仅创建 PDF 文档

📝 支持的格式

MCP 会自动处理：

Markdown

• # Heading 1 → 一级标题（20pt）
• ## Heading 2 → 二级标题（16pt，蓝色）
• ### Heading 3 → 三级标题（14pt）
• #### Heading 4 → 四级标题（12pt）
• - Item → 项目符号列表
• 1. Item → 编号列表
• **text** → 粗体文本
• *text* → 斜体文本
• ***text*** → 粗斜体
• `code` → 行内代码
• > quote → 引用块
• --- → 水平线

代码块

```javascript
async function example() {
  const data = await fetch('api.com');
  return data.json();
}
```

自动检测 JSON（v1.0.9 新增！）

JSON 对象和数组会自动检测，并格式化为代码块：

{
  "status": "success",
  "data": {
    "users": [
      {"id": 1, "name": "John"}
    ]
  }
}

无需使用 ``` 反引号！只需粘贴 JSON，即可自动应用语法高亮格式。

语法高亮颜色（VS Code Dark 主题）：

• 🟣 关键字：async、function、const、await 等（#C586C0）
• 🟠 字符串："text"、'text'（#CE9178）
• 🟢 注释：// comment、/* block */（#6A9955）
• 🟢 数字：42、3.14、0xFF（#B5CEA8）
• 🟡 函数：fetch、console.log（#DCDCAA）
• 🔵 类型/类：Promise、Array（#4EC9B0）

🎨 功能亮点

专业语法高亮

• 代码块使用深色背景（#1E1E1E）
• VS Code Dark 主题颜色
• 语言指示器标题
• 自动换行

智能分页

• 代码块不会在分页处拆分
• 标题与后续内容保持在一起
• 必要时自动分页
• 间距一致

响应式排版

• 所有内容均遵循 A4 页边距
• 长文本自动换行
• 正确控制所有元素的宽度
• 内容不会溢出

🧪 测试

测试是否正常运行：

echo '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}' | npx document-generator-mcp@latest

预期输出：可用工具列表（gerar_documento_word、gerar_documento_pdf）

🔧 故障排除

错误“use strict: not found”

如果出现此错误，说明 npm 正在使用旧的缓存版本。解决方法：

1. 使用此优化配置：

{
  "mcpServers": {
    "document-generator": {
      "command": "npx",
      "args": ["--yes", "--cache", "/tmp/.npx-cache", "document-generator-mcp@latest"]
    }
  }
}

2. 或清除缓存：

npm cache clean --force
rm -rf ~/.npm/_npx

文档未生成

• 检查 generated_documents/ 文件夹是否存在
• 确认 Node.js 版本（需要 18+）
• 查看 Agent 中的 MCP 服务日志

📁 生成的文件

文档会保存到 ./generated_documents/，并带有唯一时间戳。

示例：api_documentation_1759715959772.docx

🤖 兼容的 Agent

此 MCP 适用于任何实现了 Model Context Protocol 的 Agent：

• ✅ Claude Desktop - 完整的原生支持
• ✅ Amazon Q Developer - 通过 VS Code 支持
• ✅ Cline (VS Code) - VS Code 扩展
• ✅ Continue - 集成 MCP 的代码助手
• ✅ 其他 MCP Agent - 任何兼容的实现

🤝 贡献

欢迎贡献！请在 GitHub 上提交 issue 或拉取请求。

开发环境设置

git clone https://github.com/thiagotw10/document-generator-mcp.git
cd document-generator-mcp
npm install
npm run build

📄 许可证

MIT 许可证——详情请参阅 LICENSE 文件。

🔗 链接

• NPM 包： https://www.npmjs.com/package/document-generator-mcp
• GitHub 仓库： https://github.com/thiagotw10/document-generator-mcp
• MCP 文档： https://modelcontextprotocol.io
• Amazon Q MCP 指南： https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/qdev-mcp.html

⚠️ 要求

• Node.js： 需要 18+
• 平台： Linux、macOS、Windows
• MCP 支持： 任何实现了 Model Context Protocol 的 Agent

📊 更新日志

v1.0.9（最新）

• ✅ 自动检测 JSON 代码块 - JSON 无需用 ``` 反引号括起来
• ✅ 自动将 JSON 对象和数组格式化为代码块
• ✅ 格式化前验证 JSON 语法
• ✅ 为检测到的 JSON 添加语法高亮
• ✅ 适用于 Word 和 PDF 文档

v1.0.8

• ✅ 面向国际受众的英文文档
• ✅ 改进 README 结构

v1.0.7

• ✅ PDF 中的专业语法高亮（VS Code Dark 主题）
• ✅ 100% 响应式格式（遵循 A4 页边距）
• ✅ 智能分页（不截断内容）
• ✅ 改进代码块后的间距
• ✅ Word 和 PDF 之间的视觉效果一致

---

由 Thiago Oliveira 倾情打造 ❤️

借助 AI，将自然语言转化为专业文档！