mcp-pypandoc-hwpx

`pypandoc-hwpx` 패키지를 활용하여 .docx, .html, .md 문서를 .hwpx 문서로 변환하는 도구를 제공하는 MCP (Model Context Protocol) 서버입니다.

<video src="https://github.com/user-attachments/assets/ed60811a-49a9-4c8b-8e4e-447e04051927" controls width="600"></video>

• Python 3.12+
• Pandoc
• uv
• Docker Desktop 또는 동등한 컨테이너 도구

uv sync

<details> <summary><h4>로컬 <code>stdio</code> 서버</h4></summary>

1. MCP 서버 설정을 복사합니다.

    # zsh/bash
    cp .vscode/mcp.local.stdio.json .vscode/mcp.json

    # PowerShell
    Copy-Item .vscode/mcp.local.stdio.json .vscode/mcp.json -Force

1. VS Code에서 MCP 서버를 실행합니다.

</details>

<details> <summary><h4>로컬 Streamable HTTP 서버</h4></summary>

1. MCP 서버를 실행합니다.

    uv run python -m src.server --http --port 8000

> NOTE: 포트 번호는 원하는 값으로 설정할 수 있습니다.

1. MCP 서버 설정을 복사합니다.

    # zsh/bash
    cp .vscode/mcp.local.http.json .vscode/mcp.json

    # PowerShell
    Copy-Item .vscode/mcp.local.http.json .vscode/mcp.json -Force

1. VS Code에서 MCP 서버를 실행합니다.

</details>

<details> <summary><h4>컨테이너형 <code>stdio</code> 서버</h4></summary>

1. MCP 서버 설정을 복사합니다.

    # zsh/bash
    cp .vscode/mcp.container.stdio.json .vscode/mcp.json

    # PowerShell
    Copy-Item .vscode/mcp.container.stdio.json .vscode/mcp.json -Force

1. VS Code에서 MCP 서버를 실행합니다.

</details>

<details> <summary><h4>컨테이너형 Streamable HTTP 서버</h4></summary>

1. MCP 서버를 실행합니다.

    # zsh/bash
    docker run -i --rm -p 8000:8000 \
        --mount "type=bind,src=$HOME,dst=/home/user" \
        ghcr.io/aliencube/mcp-pypandoc-hwpx:latest --http --port 8000

    # PowerShell
    docker run -i --rm -p 8000