MD

Md2doc

Created 4 months ago

A Model Context Protocol (MCP) server that converts Markdown text to DOCX format using an external conversion service.

development documentation public

What is Md2doc?

Convert Markdown text to DOCX format using an external conversion service

Documentation

md2doc - Markdown to DOCX MCP Server

Features

  • Convert Markdown text to DOCX format
  • Support for custom templates
  • Multi-language support (English, Chinese, etc.)
  • Automatic file download to user's Downloads directory
  • Template listing and management

Usage# Cherry Studio

  1. Open Cherry Studio
  2. Go to Settings → MCP
  3. Add the server configuration:
{
  "mcpServers": {
    "md2doc": {
      "command": "uvx",
      "args": ["md2doc"],
      "env": {
        "DEEP_SHARE_API_KEY": "your-api-key-here"
      }
    }
  }
}

Claude Desktop

  1. Open your Claude Desktop configuration file:
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  1. Add the md2doc server:
{
  "mcpServers": {
    "md2doc": {
      "command": "uvx",
      "args": ["md2doc"],
      "env": {
        "DEEP_SHARE_API_KEY": "your-api-key-here"
      }
    }
  }
}
  1. Restart Claude Desktop

Command Line (Quick Start)

For immediate use without any client setup:

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

Python Integration

You can also use md2doc directly in your Python projects:

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="en",
        template_name="thesis"
    )
    response = await client.convert_text(request)
    if response.success:
        print(f"File saved to: {response.file_path}")

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

Other MCP Clients

The server works with any MCP-compatible client. Configure it to run:

uvx md2doc

With environment variables:

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

API Key# Free Trial API Key

Use this key for testing:

f4e8fe6f-e39e-486f-b7e7-e037d2ec216f

Purchase API Key

Available Tools

  • convert_markdown_to_docx: Convert markdown text to DOCX
  • list_templates: Get available templates by language

Server Config

{
  "mcpServers": {
    "md2doc-server": {
      "command": "npx",
      "args": [
        "md2doc"
      ]
    }
  }
}

Links & Status

Repository: github.com
Hosted: No
Global: No
Official: Yes

Project Info

Hosted Featured
Created At: Jul 17, 2025
Updated At: Aug 07, 2025
Author: Yorick-Ryu
Category: community
License: MIT
Tags:
development documentation public