Markdown转DOCX服务

一个基于MCP协议的服务,提供Markdown文本到DOCX格式的转换,支持多语言和自定义模板。

  • by Yorick-Ryu
  • Python
  • 本地部署
  • 8 星标
  • 更新于
在 GitHub 查看 Yorick-Ryu/md2doc-mcp

使用说明

md2doc-Markdown到DOCX MCP服务器

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

特性

  • 将Markdown文本转换为DOCX格式
  • 支持自定义模板
  • 多语言支持(英语、中文等)
  • 自动将文件下载到用户的下载目录
  • 模板列表和管理

用法

樱桃工作室

  1. 开放樱桃工作室
  2. 转到“设置”→ MCP
  3. 添加服务器配置:
    {
      "mcpServers": {
        "md2doc": {
          "command": "uvx",
          "args": ["md2doc"],
          "env": {
            "DEEP_SHARE_API_KEY": "your-api-key-here"
          }
        }
      }
    }
    

克劳德桌面版

  1. 打开您的Claude Desktop配置文件:

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • 视窗: %APPDATA%\Claude\claude_desktop_config.json
  2. 添加md2doc服务器:

    {
      "mcpServers": {
        "md2doc": {
          "command": "uvx",
          "args": ["md2doc"],
          "env": {
            "DEEP_SHARE_API_KEY": "your-api-key-here"
          }
        }
      }
    }
    
  3. 重新启动克劳德桌面

命令行(快速入门)

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

# 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:按语言获取可用模板

许可证

麻省理工学院