文档转换服务

一个基于pypandoc-hwpx包的MCP服务器,提供.docx、.html和.md文档到.hwpx格式的转换功能。

  • by aliencube
  • Python
  • 混合部署
  • 13 星标
  • 更新于
在 GitHub 查看 aliencube/mcp-pypandoc-hwpx

使用说明

pypandoc-hwpx MCP服务器

pypandoc-hwpx 利用软件包 .docx, .html, .md 将文档 .hwpx 提供转换为文档的工具 MCP(模型上下文协议) 服务器。



要求

开始

安装

uv sync

运行服务器

로컬 stdio 서버

  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
    
  2. 在VS Code中运行MCP服务器。

로컬 Streamable HTTP 서버

  1. 运行MCP服务器。

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

    备注:端口号可以设置为所需的值。

  2. 复制MCP服务器设置。

    # zsh/bash
    cp .vscode/mcp.local.http.json .vscode/mcp.json
    
    # PowerShell
    Copy-Item .vscode/mcp.local.http.json .vscode/mcp.json -Force
    
  3. 在VS Code中运行MCP服务器。

컨테이너형 stdio 서버

  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
    
  2. 在VS Code中运行MCP服务器。

컨테이너형 Streamable HTTP 서버

  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:8000 `
        --mount "type=bind,src=$HOME,dst=/home/user" `
        ghcr.io/aliencube/mcp-pypandoc-hwpx:latest --http --port 8000
    

    备注:端口号可以设置为所需的值。

  2. 复制MCP服务器设置。

    # zsh/bash
    cp .vscode/mcp.container.http.json .vscode/mcp.json
    
    # PowerShell
    Copy-Item .vscode/mcp.container.http.json .vscode/mcp.json -Force
    
  3. 在VS Code中运行MCP服务器。

원격 Streamable HTTP 서버

备注:远程MCP服务器只能转换可通过公共URL访问的文件。

  1. 登录Azure。

    azd auth login
    
  2. 部署到Azure。

    azd up
    

    备注:如果您询问Azure订阅、部署区域、环境名称等,请输入。

  3. 部署完成后,获取Remot MCP服务器URL值。

    azd env get-value AZURE_RESOURCE_MCP_PYPANDOC_HWPX_FQDN
    
  4. 复制MCP服务器设置。

    # zsh/bash
    cp .vscode/mcp.remote.http.json .vscode/mcp.json
    
    # PowerShell
    Copy-Item .vscode/mcp.remote.http.json .vscode/mcp.json -Force
    
  5. 在VS Code中运行MCP服务器。此时,请输入之前找到的Remot服务器的地址。

  6. 如果不再使用,请删除资源。

    azd down --purge --force
    

已知问题

pypandoc-hwpx 库的 说明和限制 请参阅部分。

想了解更多关于MCP的信息?

咨询