MCP 서버

AI 에이전트가 한글 문서를 읽게 하세요

MCP란?

Model Context Protocol(MCP)은 AI 어시스턴트가 외부 도구를 사용할 수 있게 하는 개방형 표준입니다. hwpx.io MCP 서버는 AI에게 HWP/HWPX 문서를 읽고 변환하는 능력을 제공합니다.

설치

전역 설치:

npm install -g @hwpxio/mcp-server

또는 npx로 설치 없이 바로 실행할 수 있습니다.

설정

AI 도구의 MCP 설정에 서버를 추가하세요.

Claude Desktop

claude_desktop_config.json

{
  "mcpServers": {
    "hwpxio": {
      "command": "npx",
      "args": ["-y", "@hwpxio/mcp-server"],
      "env": {
        "HWPXIO_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Cursor

.cursor/mcp.json

{
  "mcpServers": {
    "hwpxio": {
      "command": "npx",
      "args": ["-y", "@hwpxio/mcp-server"],
      "env": {
        "HWPXIO_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Claude Code

claude mcp add hwpxio -- npx -y @hwpxio/mcp-server

사용 가능한 Tool

read_hwpx

.hwpx 파일을 읽어 Markdown 텍스트로 반환합니다.

read_hwp

.hwp 파일을 읽어 Markdown 텍스트로 반환합니다.

convert

.hwp/.hwpx 파일을 Markdown 또는 HTML로 변환하여 디스크에 저장합니다.

read_directory

디렉토리 내 모든 HWP/HWPX 파일을 한 번에 읽습니다.

Remote MCP

호스팅된 엔드포인트를 통해 로컬 설치 없이 연결합니다. AI 클라이언트가 원격 MCP URL을 지원할 때 사용 가능합니다.

https://hwpx.io/api/v1/mcp