{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_mu97kk3fr9r7","handle":"hwp-metadata-mcp","url":"https://wellknown.network/agents/hwp-metadata-mcp","links":{"self":"https://wellknown.network/agents/hwp-metadata-mcp/record.json","html":"https://wellknown.network/agents/hwp-metadata-mcp","markdown":"https://wellknown.network/agents/hwp-metadata-mcp/record.md","api":"https://wellknown.network/api/v1/agents/hwp-metadata-mcp","status":"https://wellknown.network/api/v1/agents/hwp-metadata-mcp/status","claim":"https://wellknown.network/agents/hwp-metadata-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/hwp-metadata-mcp/claim.json","badge":"https://wellknown.network/agents/hwp-metadata-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/hwp-metadata-mcp/history","tools":"https://wellknown.network/api/v1/agents/hwp-metadata-mcp/tools"},"ard":{"identifier":"urn:air::server:hwp-metadata-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"hwp-metadata-mcp","summary":"MCP server for extracting metadata from Korean HWP/HWPX files","description":"# HWP Metadata MCP Server\n\n한글(HWP/HWPX) 파일의 메타데이터를 추출하는 MCP(Model Context Protocol) 서버입니다.\n\n## 기능\n\n- **HWP 5.0 지원**: OLE 기반 바이너리 HWP 파일\n- **HWPX 지원**: XML 기반 오픈 포맷 HWPX 파일\n- **자동 감지**: 파일 형식을 자동으로 감지하여 처리\n- **크로스 플랫폼**: Windows, Linux, macOS 지원\n- **HWP 설치 불필요**: 순수 Python 라이브러리로 구현\n\n## 추출 가능한 메타데이터\n\n- **문서 정보**: 제목, 작성자, 키워드, 주제, 설명\n- **시간 정보**: 생성일, 수정일, 마지막 인쇄일\n- **문서 통계**: 페이지 수, 단어 수, 문자 수, 문단 수\n- **보안 정보**: 암호화 여부, 읽기 전용 여부\n- **기술 정보**: HWP 버전, 사용된 글꼴 목록\n- **애플리케이션 정보**: 생성 프로그램 및 버전\n\n## 설치\n\n```bash\n# pip 사용\npip install hwp-metadata-mcp\n\n# uv 사용 (권장)\nuv add hwp-metadata-mcp\n\n# 개발 버전 설치\ngit clone https://github.com/heonseung4-del/hwp-metadata-mcp\ncd hwp-metadata-mcp\nuv pip install -e .\n```\n\n## 사용법\n\n### Claude Desktop에서 사용\n\n`claude_desktop_config.json` 파일에 다음을 추가하세요:\n\n**Windows**: `%APPDATA%/Claude/claude_desktop_config.json`\n**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"hwp-metadata\": {\n      \"command\": \"uvx\",\n      \"args\": [\"hwp-metadata-mcp\"]\n    }\n  }\n}\n```\n\n또는 로컬 설치된 경우:\n\n```json\n{\n  \"mcpServers\": {\n    \"hwp-metadata\": {\n      \"command\": \"python\",\n      \"args\": [\"-m\", \"hwp_metadata_mcp.server\"]\n    }\n  }\n}\n```\n\n### Python에서 직접 사용\n\n```python\nfrom hwp_metadata_mcp.hwp_parser import HwpParser\nfrom hwp_metadata_mcp.hwpx_parser import HwpxParser\nfrom hwp_metadata_mcp.hwp_parser import detect_file_type\n\n# 자동 감지\nfile_type = detect_file_type(\"document.hwp\")\nif file_type == \"HWP\":\n    metadata = HwpParser.parse(\"document.hwp\")\nelif file_type == \"HWPX\":\n    metadata = HwpxParser.parse(\"document.hwpx\")\n\n# 메타데이터 접근\nprint(f\"제목: {metadata.title}\")\nprint(f\"작성자: {metadata.author}\")\nprint(f\"페이지 수: {metadata.page_count}\")\nprint(f\"생성일: {metadata.created_date}\")\n```\n\n### MCP Tools\n\n서버는 다음 3개의 tool을 제공합니다:\n\n#### 1. `extract_metadata` (권장)\n파일 형식을 자동으로 감지하여 메타데이터 추출\n\n```python\n# Claude Desktop에서:\n# \"이 HWP 파일의 메타데이터를 알려줘: /path/to/file.hwp\"\n```\n\n#### 2. `extract_hwp_metadata`\nHWP 5.0 파일 전용\n\n#### 3. `extract_hwpx_meta…","publisher":null,"homepage":"https://github.com/heonseung4-del/hwp-metadata-mcp","repository":"https://github.com/heonseung4-del/hwp-metadata-mcp","version":"1.0.0","license":"BSD-3-Clause","protocols":["mcp"],"tags":["document","hancom","hwp","hwpx","korean","mcp","metadata"],"pricing":null,"endpoints":[{"url":"pypi:hwp-metadata-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"}],"categories":["dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"hwp-metadata-mcp","registry":"pypi","observedAt":"2026-09-15T16:22:21.573Z","publishedAt":"2025-11-11T17:46:38.958373Z","latestVersion":"1.0.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"hwp-metadata-mcp","url":"https://pypi.org/project/hwp-metadata-mcp/","firstSeenAt":"2026-09-09T17:21:40.003Z","fetchedAt":"2026-09-15T16:21:17.119Z","normalizedAt":"2026-09-15T16:21:17.119Z"}]},"firstSeenAt":"2026-09-09T17:21:40.003Z","updatedAt":"2026-09-15T16:22:21.573Z"}