md2doc - Markdown 转 DOCX MCP 服务器

一个使用外部转换服务将 Markdown 文本转换为 DOCX 格式的模型上下文协议 (MCP) 服务器。

功能特性

• 将 Markdown 文本转换为 DOCX 格式

• 支持自定义模板

• 支持多语言（英语、中文等）

• 自动下载文件到用户的“下载”目录

• 模板列表查看与管理

使用方法

Cherry Studio

1. 打开 Cherry Studio

2. 进入 设置 → MCP

3. 添加服务器配置：

   {
     "mcpServers": {
       "md2doc": {
         "command": "uvx",
         "args": ["md2doc"],
         "env": {
           "DEEP_SHARE_API_KEY": "your-api-key-here"
         }
       }
     }
   }

Claude Desktop

1. 打开你的 Claude Desktop 配置文件：

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

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

2. 添加 md2doc 服务器：

   {
     "mcpServers": {
       "md2doc": {
         "command": "uvx",
         "args": ["md2doc"],
         "env": {
           "DEEP_SHARE_API_KEY": "your-api-key-here"
         }
       }
     }
   }

3. 重启 Claude Desktop

命令行（快速开始）

无需任何客户端设置即可立即使用：

# Install and run the server
uvx md2doc

# Or with environment variable
DEEP_SHARE_API_KEY="your-api-key-here" uvx md2doc

Python 集成

你也可以在 Python 项目中直接使用 md2doc：

import asyncio
from md2doc.api_client import ConversionAPIClient
from md2doc.models import ConvertTextRequest

async def convert_markdown():
    client = ConversionAPIClient()
    
    request = ConvertTextRequest(
        content="# Hello World\n\nThis is **markdown** content.",
        filename="example",
        language="zh",
        template_name="templates",
        remove_hr=False,
        compat_mode=True
    )
    
    response = await client.convert_text(request)
    if response.success:
        print(f"File saved to: {response.file_path}")

# Run the conversion
asyncio.run(convert_markdown())

其他 MCP 客户端

该服务器适用于任何兼容 MCP 的客户端。配置其运行：

uvx md2doc

使用环境变量：

DEEP_SHARE_API_KEY="your-api-key-here" uvx md2doc

云端部署（远程服务器）

在云服务器（VPS/Docker）上部署此 MCP 服务器时，设置 MCP_SAVE_REMOTE=true 以返回临时下载链接，而不是保存到本地目录：

# In your cloud environment
export DEEP_SHARE_API_KEY="your-api-key-here"
export MCP_SAVE_REMOTE=true

uvx md2doc

服务器将提供转换后文档的下载链接。

API 密钥

免费试用 API 密钥

使用此密钥进行测试：

f4e8fe6f-e39e-486f-b7e7-e037d2ec216f

购买 API 密钥

• 购买链接

• 中国大陆购买

可用工具

• convert_markdown_to_docx: 将 markdown 文本转换为 DOCX

• list_templates: 按语言获取可用模板

许可证

MIT