md2doc-mcp

# md2doc - Markdown to DOCX MCP Server [](https://badge.fury.io/py/md2doc) [](https://lobehub.com/mcp/yorick-ryu-md2doc-mcp) [](https://opensource.org/licenses/MIT) A Model Context Protocol (MCP) server that converts Markdown text to DOCX format using an external conversion service. <img src="https://raw.githubusercontent.com/Yorick-Ryu/md2doc-mcp/master/images/md2doc.png" alt="md2doc Demo" width="600" style="max-width: 100%; height: auto;"> ## 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: ```json { "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` 2. Add the md2doc server: ```json { "mcpServers": { "md2doc": { "command": "uvx", "args": ["md2doc"], "env": { "DEEP_SHARE_API_KEY": "your-api-key-here" } } } } ``` 3. Restart Claude Desktop ### Command Line (Quick Start) For immediate use without any client setup: ```bash # Install and run the server uvx md2doc # 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: ```python 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()) ``` ### Other MCP Clients The server works with any MCP-compatible client. Configure it to run: ```bash uvx md2doc ``` With environment variables: ```bash DEEP_SHARE_API_KEY="your-api-key-here" uvx md2doc ``` ### Cloud Deployment (Remote Server) When deploying this MCP server on a cloud server (VPS/Docker), set `MCP_SAVE_REMOTE=true` to return a temporary download link instead of saving to a local directory: ```bash # In your cloud environment export DEEP_SHARE_API_KEY="your-api-key-here" export MCP_SAVE_REMOTE=true uvx md2doc ``` The server will provide a download link for the converted document. ## API Key ### Free Trial API Key Use this key for testing: ``` f4e8fe6f-e39e-486f-b7e7-e037d2ec216f ``` ### Purchase API Key - [Purchase Link](https://www.deepshare.app/en/price.html) - [中国大陆购买](https://www.deepshare.app/price.html) ## Available Tools - `convert_markdown_to_docx`: Convert markdown text to DOCX - `list_templates`: Get available templates by language ## License MIT