MDMagic MCP 服务器

使用您自己的 Word 模板（信头、品牌标识、字体）将 Markdown 转换为 DOCX、PDF 和 HTML。 此外，还提供 15 款设计师精心制作的模板，供您在没有自定义模板时使用。

MDMagic 可直接接入 Claude、Cursor、VS Code 以及任何兼容 MCP 的 AI 助手，使它们能够直接访问专业的文档转换流水线（Pandoc + Microsoft Graph + Mammoth.js），更重要的是，能够访问您的模板。上传您现有的信头、信纸、品牌指南、合同草稿或提案模板——任何您已经在 Microsoft Word 中使用的内容——您的 AI 助手即可将任何 Markdown 直接转换为带有您的徽标、字体、颜色、页脚、页码、水印和签名块的精美文档。输出效果看起来就像是由您的设计团队制作的，而不是通用的 AI 导出文件。

You: "Take this report and turn it into an Executive_Platinum PDF."

Claude: ✅ Done. Here's your secure download link.
        14-page PDF, 2.3 MB, expires in 60 minutes.

安装

您需要一个 MDMagic 账户（提供免费层级）并从您的账户页面获取 API 密钥。

Claude Desktop

将其添加到您的 claude_desktop_config.json 中：

{
  "mcpServers": {
    "mdmagic": {
      "command": "npx",
      "args": ["-y", "@mdmagic/mcp-server"],
      "env": {
        "MDMAGIC_API_KEY": "mdmagic-xxxxxxxxxxxxxxxx"
      }
    }
  }
}

配置文件位置：

• macOS — ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows — %APPDATA%\Claude\claude_desktop_config.json

• Linux — ~/.config/Claude/claude_desktop_config.json

重启 Claude Desktop。MDMagic 工具将出现在工具列表中。

Cursor

添加到 ~/.cursor/mcp.json（或通过设置 → MCP）：

{
  "mcpServers": {
    "mdmagic": {
      "command": "npx",
      "args": ["-y", "@mdmagic/mcp-server"],
      "env": {
        "MDMAGIC_API_KEY": "mdmagic-xxxxxxxxxxxxxxxx"
      }
    }
  }
}

VS Code (使用 MCP 扩展)

{
  "mcp.servers": {
    "mdmagic": {
      "command": "npx",
      "args": ["-y", "@mdmagic/mcp-server"],
      "env": {
        "MDMAGIC_API_KEY": "mdmagic-xxxxxxxxxxxxxxxx"
      }
    }
  }
}

托管版（无需安装）

不想在机器上安装 Node？使用托管端点：

{
  "mcpServers": {
    "mdmagic": {
      "url": "https://api.mdmagic.ai/mcp",
      "headers": {
        "x-api-key": "mdmagic-xxxxxxxxxxxxxxxx"
      }
    }
  }
}

相同的工具，相同的模板，通过 Streamable HTTP 提供服务。适用于不运行本地进程的客户端。

Related MCP server: AI Group Markdown to Word MCP Server

您可以做什么

连接后，您可以向 AI 助手询问如下内容：

• “使用 Executive_Platinum 模板将此 markdown 转换为 PDF。”

• “我有哪些可用模板？”

• “将这份 800 字的报告渲染为 DOCX + PDF 需要多少积分？”

• “使用 Legal_Burgundy 模板，以横向、US Letter 纸张大小渲染此内容。”

• “检查我的积分余额。”

AI 会选择正确的工具并返回一个安全的、有时效性的下载链接。

工具

convert_document — 输入选项

提供源文件的三种方式：

• content — 原始 markdown 字符串（最常用）

• filePath — .md 文件的绝对路径（非常适合 IDE 工作流）

• fileContent — base64 编码的 markdown（用于二进制安全传输）

此外：

• templateName — 例如 Executive_Platinum、Legal_Burgundy 或自定义模板 UUID

• outputFormat — docx、pdf、html、all 或 all-formats

• pageSize — A4、A3、US_Letter、US_Legal、Executive

• orientation — Portrait 或 Landscape

配置

大多数用户只需设置 MDMAGIC_API_KEY。

定价

转换需要消耗积分，根据页数和输出格式计算：

• DOCX: 每页 1 积分（基础）

• PDF: 每页 +1 积分

• HTML: 每页 +1 积分

• 自定义模板: 每页 +1 积分

一份 5 页的报告使用自定义模板转换为 DOCX + PDF + HTML = 5 × (1 + 1 + 1 + 1) = 20 积分。

estimate_conversion_cost 工具会在您花费任何积分之前返回确切数字。如果您的余额不足，MCP 也会拒绝运行——不会有意外账单。

免费层级积分每月更新。付费计划和积分充值可在 mdmagic.ai 获取。

隐私

• 无永久存储。 文档通过 Microsoft Graph API 进行 PDF 渲染，并在 5-10 秒内删除。输出文件在下载后或 60 分钟后（以先到者为准）从 MDMagic 服务器删除。

• 随机文件名。 源文件使用 UUID，从不使用可识别用户身份的名称。

• 安全下载 URL。 每次转换返回一个带有会话 ID 和下载令牌的一次性 URL。没有公共文件目录。

• API 密钥隔离。 每个用户使用自己的密钥进行身份验证。没有共享凭据。

故障排除

MDMAGIC_API_KEY environment variable is required 在您的客户端配置中设置环境变量（JSON 中的 env 块）。不要在 shell 中设置——npx 看不到它。

Invalid API key format 密钥必须匹配 mdmagic- 后跟 16 位数字。请从您的账户页面准确复制。

Failed to connect to MDMagic API 在浏览器中检查 https://api.mdmagic.ai/health。如果它正常，则问题出在本地网络或防火墙。确认运行 MCP 的机器可以访问 MDMAGIC_BASE_URL（默认 https://api.mdmagic.ai）。

工具未出现在 Claude Desktop 中 编辑 claude_desktop_config.json 后，请完全退出并重新启动 Claude Desktop——仅关闭窗口是不够的。

Insufficient credits 使用 check_credit_balance 确认余额，使用 estimate_conversion_cost 预览成本，或在 mdmagic.ai/account 充值。

本地开发

git clone https://github.com/MDMagic-MCP/mdmagic-mcp-server.git
cd mdmagic-mcp-server
npm install

# Set your API key (use http://localhost:3000 if running the API locally)
cp .env.example .env
# edit .env

# Build and inspect
npm run build
npm run inspector

MCP Inspector (npm run inspector) 会启动一个 Web UI，用于逐个测试服务器工具——在添加新工具或调试参数验证时非常有用。

使用 npm test 运行测试。

链接

• MDMagic — mdmagic.ai

• 获取 API 密钥 — mdmagic.ai/account

• 问题反馈 — github.com/MDMagic-MCP/mdmagic-mcp-server/issues

• MCP 规范 — modelcontextprotocol.io

许可证

MIT — 参见 LICENSE。