md2doc - Markdown to DOCX MCP 서버

외부 변환 서비스를 사용하여 Markdown 텍스트를 DOCX 형식으로 변환하는 모델 컨텍스트 프로토콜(MCP) 서버입니다.

기능

• Markdown 텍스트를 DOCX 형식으로 변환

• 사용자 지정 템플릿 지원

• 다국어 지원 (영어, 중국어 등)

• 사용자 다운로드 디렉토리로 자동 파일 다운로드

• 템플릿 목록 조회 및 관리

사용법

Cherry Studio

1. Cherry Studio를 엽니다.

2. 설정(Settings) → 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

클라우드 배포 (원격 서버)

이 MCP 서버를 클라우드 서버(VPS/Docker)에 배포할 때, 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: 마크다운 텍스트를 DOCX로 변환

• list_templates: 언어별 사용 가능한 템플릿 조회

라이선스

MIT