在你的 AI 智能体里把 Markdown 转成 Word

MD2Doc 的 MCP 服务器让 Claude Code、Cursor、Windsurf 和其他 AI 智能体直接把 Markdown 转成 Word 文档——不用浏览器,不用复制粘贴,不用来回切换。

claude mcp add --transport http md2doc https://md2doc.com/mcp

Endpoint: https://md2doc.com/mcp · Streamable HTTP · Free · No API key

为什么通过 MCP 使用 MD2Doc?

浏览器工具适合偶尔转一次。MCP 服务器给每天都在 AI 编程环境里工作的开发者和高级用户。

⚡

零上下文切换

留在 Claude Code、Cursor 或 Windsurf 里。要一份 Word 文档,不用离开编辑器就能拿到下载链接。

🤖

完全自动化

智能体可以把 Markdown 转成 Word,作为更大任务的一部分——写文档、生成报告、总结研究——全程不用手动操作。

☁️

本地什么都不用装

MCP 服务器跑在 md2doc.com 上。没有二进制文件,没有 Docker,没有更新。把 URL 加一次,就能用——你用的每台机器上都是。

如何使用

1

服务器只加一次

在终端里运行安装命令。大约 10 秒。这个 URL 会写进你的智能体配置。

claude mcp add --transport http md2doc https://md2doc.com/mcp
2

用自然语言吩咐你的智能体

没有特殊语法。说清楚你要什么,智能体就会自动调用 MD2Doc。

“把这段 Markdown 转成 Word 文件,保存到我的桌面”
3

获取下载链接

MD2Doc 在服务器端转换文件,并返回一次性下载链接。10 分钟内有效。点击即可保存。

https://md2doc.com/mcp/download/abc123

由智能体安装

MD2Doc 适用于任何兼容 MCP 的智能体。在下面选你的。

Claude Code 推荐

Claude Code 是 Anthropic 的官方命令行工具。一条命令就能把服务器装到全局。

claude mcp add --transport http md2doc https://md2doc.com/mcp

That is Streamable HTTP — the current MCP remote transport. Verify with /mcp — md2doc should appear as connected.

Claude Desktop

编辑你的 Claude Desktop 配置文件,加入 md2doc 服务器:

Mac:~/Library/Application Support/Claude/claude_desktop_config.json

Windows:%APPDATA%\Claude\claude_desktop_config.json

{ "mcpServers": { "md2doc": { "type": "http", "url": "https://md2doc.com/mcp" } } }

Restart Claude Desktop after saving. Use "type": "http" — not SSE.

Cursor

把 MD2Doc 加到你的全局 Cursor MCP 配置。创建或编辑这个文件:

~/.cursor/mcp.json

{ "mcpServers": { "md2doc": { "type": "http", "url": "https://md2doc.com/mcp" } } }

或者在项目目录的 .cursor/mcp.json 里添加,做项目级访问。

Windsurf

编辑 Windsurf 的 MCP 配置文件:

~/.codeium/windsurf/mcp_config.json

{ "mcpServers": { "md2doc": { "url": "https://md2doc.com/mcp" } } }

Reload Windsurf after saving the config. Point at /mcp, not /mcp/sse.

Hermes

Hermes and other HTTP-only agents should use the Streamable HTTP URL — this is the default, not a fallback:

mcp_servers: md2doc: url: "https://md2doc.com/mcp"

POST JSON-RPC to that URL. Do not use /mcp/sse.

OpenClaw

OpenClaw 从命令行注册 MCP 服务器。一条命令,md2doc 就能在任何会话里用:

openclaw mcp set md2doc '{"url":"https://md2doc.com/mcp"}'

Use Streamable HTTP at https://md2doc.com/mcp. Only use /mcp/sse if the client cannot speak HTTP.

任何兼容 MCP 的智能体

Use Streamable HTTP unless your client cannot. SSE is a deprecated fallback.

Recommended — Streamable HTTP:

https://md2doc.com/mcp

Legacy SSE (only if HTTP fails):

https://md2doc.com/mcp/sse

For JSON configs (Cline, Continue, Zed, etc.), add the server under "mcpServers" with "type": "http" and "url": "https://md2doc.com/mcp".

大型 Markdown 文件

Markdown 超过大约 50KB 时,智能体可以在带外上传文件,这样内容就不会占用智能体工具调用的 token 预算。智能体跑一条 shell 命令,拿回一个短 ID,再把这个 ID 传给 convert_to_docx:

# 1. 上传(文件字节从磁盘流向服务器,智能体从不读取它们) curl -F [email protected] https://md2doc.com/mcp/upload # → {"id":"abc..."} # 2. 调用工具时用 markdown_upload_id,而不是 markdown convert_to_docx({ markdown_upload_id: "abc...", filename: "report" })

上传 ID 只能用一次,最大 5MB,10 分钟后过期。

可用工具

MD2Doc 的 MCP 服务器提供四个工具,你的智能体可以调用:

convert_to_docx

把 Markdown 转成 Microsoft Word(.docx)文件。返回一个 10 分钟内有效的临时下载地址。

{ "name": "convert_to_docx", "arguments": { "markdown": "# 标题\n\n内容...", "filename": "my-report" } }

返回: 下载地址 + 文件大小

convert_to_pdf

把 Markdown 转成 PDF,通过无头 Chrome 渲染,表格、代码块和排版都和网站上的预览一致。返回一个 10 分钟内有效的临时下载地址。适合分享、打印或归档的精美只读文档。

{ "name": "convert_to_pdf", "arguments": { "markdown": "# 标题\n\n内容...", "filename": "my-report" } }

返回: 下载地址 + 文件大小

convert_to_html

把 Markdown 转成带内嵌 CSS 的独立样式 HTML 文档。返回一个 10 分钟内有效的临时下载地址。用来嵌进网站、粘贴进 CMS,或当作邮件正文发送。

{ "name": "convert_to_html", "arguments": { "markdown": "# 标题\n\n内容...", "filename": "my-report" } }

返回: 下载地址 + 文件大小

preview_markdown

把 Markdown 转成 HTML 预览,精确显示 Word 文档会是什么样子。适合需要在下载前核对输出的智能体。

{ "name": "preview_markdown", "arguments": { "markdown": "# 标题\n\n内容..." } }

返回: HTML 字符串

对你的智能体说什么

MD2Doc 连上之后,你可以用自然语言要 Word 文档。这些提示语效果不错:

  • 把这段 Markdown 转成 Word 文件,保存到我的桌面
  • 把 Claude 的输出变成我能发给团队的 .docx
  • 用 Markdown 写一份项目方案,并下载为 Word 文档
  • 总结这份研究,并导出为带格式的 Word 文件
  • 把我的 README.md 转成 Word 文档,用于客户演示
  • 根据这份会议记录生成会议纪要,并下载为 .docx

技术细节

协议

MCP Streamable HTTP is the current remote transport. Point clients at https://md2doc.com/mcp (POST JSON-RPC). Legacy HTTP+SSE at /mcp/sse is kept for older clients only.

端点

# Streamable HTTP (recommended) POST /mcp # Legacy SSE connection GET /mcp/sse # Send JSON-RPC messages (SSE flow) POST /mcp/messages?sessionId=X # Out-of-band markdown upload POST /mcp/upload # Download generated file GET /mcp/download/{id}

性能

100KB 以内的 Markdown,典型转换时间不到 2 秒。生成的 .docx 文件保存 10 分钟后自动删除。

隐私

Markdown 内容会发送到 md2doc.com 进行转换,不会被记录或保留。下载链接一次性使用,10 分钟后过期。

MCP 常见问题

MCP 是什么,为什么重要?

MCP(模型上下文协议)是 Anthropic 提出的开放标准,让 AI 智能体连接外部工具和服务。智能体不用描述怎么用工具,而是直接调用——就像函数调用。工作流因此更快、更可靠,而且完全自动化。

需要 API 密钥吗?

不用。MD2Doc 的 MCP 服务器免费且开放。加上服务器地址就能用。不用注册,不用信用卡。

Which URL should I use?

Use https://md2doc.com/mcp (Streamable HTTP). That is the current MCP remote transport and the one HTTP-only connectors (Hermes, Estate, custom bots) can actually load. The old SSE URL at https://md2doc.com/mcp/sse still works for some Claude Code / Cursor setups, but it is deprecated — do not give it to a client that failed on SSE.

SSE isn't working. Now what?

Swap the URL to https://md2doc.com/mcp and set the transport to HTTP / Streamable HTTP. Do not GET that URL in a browser expecting JSON — the MCP protocol is POST. The website converter at md2doc.com still works if you skip MCP entirely.

MD2Doc 能生成哪些文件格式?

convert_to_docx 工具会生成标准的 .docx 文件,兼容 Microsoft Word 2010 及更高版本、Google Docs、LibreOffice 和所有主流文档编辑器。

支持哪些 Markdown 功能?

标题(H1–H6)、粗体、斜体、删除线、有序和无序列表、表格、围栏代码块、行内代码、引用块和超链接。和网页转换器功能相同。

有速率限制吗?

目前合理使用没有速率限制。这项服务面向开发者工作流和个人使用。如果你需要大批量转换,请联系我们。

我能在自己的应用里用这个吗?

可以。REST API https://md2doc.com/convert 和 https://md2doc.com/download-docx 也可供程序调用。完整 API 文档见 LLM.md。

智能体 Markdown 故事的另一半

FolderMD 是我们为智能体产出的长文 Markdown 做的桌面阅读器。不用再在终端或聊天窗口里眯着眼看 400 行的回复——智能体可以直接写进一个平静、好看、专门为此设计的阅读体验。

访问 foldermd.com →

准备把 MD2Doc 加到你的智能体了吗?

一条命令。免费。无需注册。

claude mcp add --transport http md2doc https://md2doc.com/mcp

如果只是偶尔转一次,也可以用 浏览器转换器。

需要更高并发,或碰到「服务器忙」错误?在 X 上私信 @kirillzubovsky——我们会给你开一个专用账号。