MDMagic MCP 서버

사용자 지정 Word 템플릿(레터헤드, 브랜딩, 폰트 등)을 사용하여 Markdown을 DOCX, PDF 및 HTML로 변환하세요. 자체 템플릿이 없는 경우를 위해 15가지 디자이너 제작 템플릿도 제공합니다.

MDMagic은 Claude, Cursor, VS Code 및 모든 MCP 호환 AI 어시스턴트에 직접 연결되어 전문적인 문서 변환 파이프라인(Pandoc + Microsoft Graph + Mammoth.js)과 사용자 템플릿에 직접 액세스할 수 있게 해줍니다. 기존 레터헤드, 문구류, 브랜드 가이드라인, 계약서 양식, 제안서 템플릿 등 Microsoft Word에서 사용하는 모든 것을 업로드하면, AI 어시스턴트가 Markdown을 사용자의 로고, 폰트, 색상, 바닥글, 페이지 번호, 워터마크 및 서명 블록이 포함된 세련된 문서로 직접 변환합니다. 결과물은 일반적인 AI 내보내기가 아닌 디자인 팀이 작업한 것처럼 보입니다.

You: "Take this report and turn it into an Executive_Platinum PDF."

Claude: ✅ Done. Here's your secure download link.
        14-page PDF, 2.3 MB, expires in 60 minutes.

설치

MDMagic 계정(무료 티어 제공)이 필요하며 계정 페이지에서 API 키를 발급받아야 합니다.

Claude Desktop

claude_desktop_config.json에 다음을 추가하세요:

{
  "mcpServers": {
    "mdmagic": {
      "command": "npx",
      "args": ["-y", "@mdmagic/mcp-server"],
      "env": {
        "MDMAGIC_API_KEY": "mdmagic-xxxxxxxxxxxxxxxx"
      }
    }
  }
}

설정 파일 위치:

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

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

• Linux — ~/.config/Claude/claude_desktop_config.json

Claude Desktop을 재시작하세요. 도구 목록에 MDMagic 도구가 나타납니다.

Cursor

~/.cursor/mcp.json에 추가하거나 설정 → MCP를 통해 추가하세요:

{
  "mcpServers": {
    "mdmagic": {
      "command": "npx",
      "args": ["-y", "@mdmagic/mcp-server"],
      "env": {
        "MDMAGIC_API_KEY": "mdmagic-xxxxxxxxxxxxxxxx"
      }
    }
  }
}

VS Code (MCP 확장 프로그램 사용)

{
  "mcp.servers": {
    "mdmagic": {
      "command": "npx",
      "args": ["-y", "@mdmagic/mcp-server"],
      "env": {
        "MDMAGIC_API_KEY": "mdmagic-xxxxxxxxxxxxxxxx"
      }
    }
  }
}

호스팅 버전 (설치 불필요)

사용자 컴퓨터에 Node를 설치하고 싶지 않으신가요? 호스팅된 엔드포인트를 사용하세요:

{
  "mcpServers": {
    "mdmagic": {
      "url": "https://api.mdmagic.ai/mcp",
      "headers": {
        "x-api-key": "mdmagic-xxxxxxxxxxxxxxxx"
      }
    }
  }
}

동일한 도구와 템플릿을 Streamable HTTP를 통해 제공합니다. 로컬 프로세스를 실행하지 않는 클라이언트에게 유용합니다.

Related MCP server: AI Group Markdown to Word MCP Server

주요 기능

연결 후 AI 어시스턴트에게 다음과 같이 요청할 수 있습니다:

• "이 마크다운을 Executive_Platinum 템플릿을 사용하여 PDF로 변환해 줘."

• "사용 가능한 템플릿이 뭐야?"

• "이 800단어 보고서를 DOCX + PDF로 렌더링하는 데 몇 크레딧이 필요해?"

• "이것을 가로 방향, US Letter 크기, Legal_Burgundy 템플릿으로 렌더링해 줘."

• "내 크레딧 잔액을 확인해 줘."

AI가 적절한 도구를 선택하고 안전한 기간 한정 다운로드 링크를 반환합니다.

도구

convert_document — 입력 옵션

소스를 제공하는 세 가지 방법:

• content — 원시 마크다운 문자열 (가장 일반적)

• filePath — .md 파일의 절대 경로 (IDE 워크플로우에 적합)

• fileContent — base64로 인코딩된 마크다운 (바이너리 안전 전송용)

추가 옵션:

• templateName — 예: Executive_Platinum, Legal_Burgundy 또는 사용자 지정 템플릿 UUID

• outputFormat — docx, pdf, html, all 또는 all-formats

• pageSize — A4, A3, US_Letter, US_Legal, Executive

• orientation — Portrait 또는 Landscape

설정

대부분의 사용자는 MDMAGIC_API_KEY만 설정하면 됩니다.

가격

변환 비용은 페이지 수와 출력 형식에 따라 크레딧으로 계산됩니다:

• DOCX: 페이지당 1 크레딧 (기본)

• PDF: 페이지당 +1 크레딧

• HTML: 페이지당 +1 크레딧

• 사용자 지정 템플릿: 페이지당 +1 크레딧

사용자 지정 템플릿을 사용하여 5페이지 보고서를 DOCX + PDF + HTML로 변환하는 경우 = 5 × (1 + 1 + 1 + 1) = 20 크레딧.

estimate_conversion_cost 도구는 비용을 지불하기 전에 정확한 수치를 반환합니다. 또한 잔액이 부족하면 MCP가 실행을 거부하므로 예상치 못한 청구서가 발생하지 않습니다.

무료 티어 크레딧은 매달 갱신됩니다. 유료 플랜 및 크레딧 충전은 mdmagic.ai에서 가능합니다.

개인정보 보호

• 영구 저장 없음. 문서는 PDF 렌더링을 위해 Microsoft Graph API를 거치며 5~10초 이내에 삭제됩니다. 출력 파일은 다운로드 후 또는 60분 후(둘 중 빠른 시점)에 MDMagic 서버에서 삭제됩니다.

• 무작위 파일명. 소스 파일은 UUID를 사용하며, 사용자를 식별할 수 있는 이름은 절대 사용하지 않습니다.

• 보안 다운로드 URL. 각 변환은 세션 ID와 다운로드 토큰이 포함된 일회용 URL을 반환합니다. 공개 파일 디렉토리는 없습니다.

• API 키 격리. 각 사용자는 자신의 키로 인증합니다. 공유 자격 증명은 없습니다.

문제 해결

MDMAGIC_API_KEY environment variable is required 클라이언트 설정(JSON의 env 블록)에 환경 변수를 설정하세요. 셸에 넣지 마세요. npx는 이를 인식하지 못합니다.

Invalid API key format 키는 mdmagic- 뒤에 정확히 16자리 숫자가 와야 합니다. 계정 페이지에서 정확히 복사하세요.

Failed to connect to MDMagic API 브라우저에서 https://api.mdmagic.ai/health를 확인하세요. 접속이 가능하다면 로컬 네트워크나 방화벽 문제입니다. MCP를 실행 중인 컴퓨터에서 MDMAGIC_BASE_URL(기본값 https://api.mdmagic.ai)에 도달할 수 있는지 확인하세요.

Claude Desktop에 도구가 나타나지 않음 claude_desktop_config.json을 수정한 후 Claude Desktop을 완전히 종료하고 다시 실행하세요. 창을 닫는 것만으로는 충분하지 않습니다.

Insufficient credits check_credit_balance를 사용하여 잔액을 확인하고, estimate_conversion_cost로 비용을 미리 확인하거나 mdmagic.ai/account에서 충전하세요.

로컬 개발

git clone https://github.com/MDMagic-MCP/mdmagic-mcp-server.git
cd mdmagic-mcp-server
npm install

# Set your API key (use http://localhost:3000 if running the API locally)
cp .env.example .env
# edit .env

# Build and inspect
npm run build
npm run inspector

MCP Inspector(npm run inspector)는 도구별로 서버를 테스트할 수 있는 웹 UI를 실행합니다. 새로운 도구를 추가하거나 인수 유효성 검사를 디버깅할 때 유용합니다.

npm test로 테스트를 실행하세요.

링크

• MDMagic — mdmagic.ai

• API 키 발급 — mdmagic.ai/account

• 이슈 — github.com/MDMagic-MCP/mdmagic-mcp-server/issues

• MCP 사양 — modelcontextprotocol.io

라이선스

MIT — LICENSE를 참조하세요.