OK AgentHWP MCP 서버 — AI가 한글 파일(.hwp·.hwpx) 읽기
자체 파서로 .hwp·.hwpx 문서를 마크다운으로 바꾸고 표를 JSON으로 추출해, AI 에이전트가 공문·계약서·견적서 같은 한글 파일을 읽을 수 있게 해 주는 무료 오픈소스 서버입니다. API 키가 필요 없습니다.
@appmonster/mcp-hwp무료 · MIT 오픈소스API 키 필요 없음GitHub →
무엇을 할 수 있나
| 도구 | 하는 일 |
|---|---|
hwp_info | 문서 정보(형식·버전·제목·암호/배포용 여부) |
hwp_to_markdown | 본문을 마크다운으로 변환 |
hwp_extract_tables | 표를 JSON으로 추출 |
설치 (1분)
Node.js 20 이상이 필요합니다. 따로 내려받을 것 없이 npx가 실행할 때 가져옵니다.
Claude Desktop · Cursor · Windsurf
MCP 설정 파일(claude_desktop_config.json, .cursor/mcp.json 등)에 넣습니다.
{
"mcpServers": {
"hwp": {
"command": "npx",
"args": [
"-y",
"@appmonster/mcp-hwp"
]
}
}
}Claude Code
claude mcp add hwp -- npx -y @appmonster/mcp-hwp필요한 키와 발급처
필요 없습니다. 설치하면 바로 씁니다.
이렇게 시켜 보세요
- “이 공문(.hwp) 핵심 내용과 제출 기한만 뽑아줘.”
- “견적서 표에서 품목·수량·단가 합계 계산해줘.”
- “이 계약서에서 위약금 조항만 찾아서 요약해줘.”
자주 묻는 질문
한글 프로그램이 설치돼 있어야 하나요?
아니요. 서버에 자체 파서가 들어 있어 한컴오피스 없이도 읽습니다.
파일이 외부로 전송되나요?
변환은 내 컴퓨터에서 실행되는 서버 안에서 이뤄집니다. 변환된 글을 AI에 보내는 것은 쓰는 AI 프로그램의 정책을 따릅니다.
암호 걸린 파일도 되나요?
암호가 걸린 문서는 읽을 수 없습니다. 한글에서 암호를 풀고 다시 시도하라는 안내가 나옵니다.