hwpx-mcp-server

Provides a local Model Context Protocol (MCP) server that uses python-hwpx to automate handling of HWPX (.hwpx) documents from AI clients (read, search, edit, extract). Includes an optional advanced toolset enabled via environment variable.

Evaluated Mar 30, 2026 (21d ago)

Repo ↗ Ai Ml mcp python hwpx document-automation local-files ai-integration

⚙ Agent Friendliness

/ 100

Can an agent use this?

🔒 Security

/ 100

Is it safe for agents?

⚡ Reliability

/ 100

Does it work consistently?

Score Breakdown

⚙ Agent Friendliness

MCP Quality

Documentation

Error Messages

Auth Simplicity

100

Rate Limits

🔒 Security

TLS Enforcement

Auth Strength

Scope Granularity

Dep. Hygiene

Secret Handling

Appears designed for local/offline MCP usage with no described authentication or authorization. This reduces remote attack surface but increases risk if exposed to untrusted clients or if the agent can read/write arbitrary filesystem paths. Advanced tools that inspect package parts/XML may reveal sensitive content if used on confidential documents. TLS/auth details for any network exposure are not described.

⚡ Reliability

Uptime/SLA

Version Stability

Breaking Changes

Error Recovery

Best When

Running locally (or in a controlled environment) with an MCP-capable desktop/editor client to automate document inspection/transformation on .hwpx files.

Avoid When

When you need secure multi-user remote access with robust authentication/authorization, or when input files are untrusted and you cannot sandbox filesystem access.

Use Cases

• Convert HWPX documents to Markdown/HTML/structured JSON for downstream AI processing
• Search within HWPX text and perform targeted text replacements
• Edit HWPX content (add/insert/delete paragraphs, headings, page breaks, memos)
• Create and modify tables (set cell text, merge/split cells, basic formatting)
• Validate/lint document structure and conventions using advanced MCP tools

Not For

• Direct editing of legacy binary HWP (.hwp) format (not supported by the stated scope)
• Production deployments requiring centralized authentication, webhooks, or internet-facing HTTP APIs
• Use cases that require strong governance/auditing features beyond local file operations

Interface

REST API

GraphQL

gRPC

MCP Server

Yes

SDK

Webhooks

Authentication

OAuth: No Scopes: No

No authentication mechanism is described in the README; the server appears intended for local use from trusted MCP clients.

Pricing

Free tier: No

Requires CC: No

Open-source (MIT) with local execution; operational costs depend on your environment/AI client.

Agent Metadata

Pagination

none

Idempotent

False

Retry Guidance

Not documented

Known Gotchas

⚠ Advanced toolset is gated by HWPX_MCP_ADVANCED=1; without it, expected tools may be unavailable.
⚠ Text extraction/return sizes are controlled by HWPX_MCP_MAX_CHARS (or per-call max_chars); large documents may truncate.
⚠ Tools use a stateless calling pattern with explicit filename parameters (agents must pass correct paths).
⚠ Binary .hwp format is not supported; use .hwpx.

Alternatives

python-hwpx (library-only integration, no MCP layer) Custom scripts wrapping python-hwpx endpoints/tools directly in your own app General document conversion pipelines that output text/HTML (where HWPX fidelity is not critical)

Full Evaluation Report

Comprehensive deep-dive: security analysis, reliability audit, agent experience review, cost modeling, competitive positioning, and improvement roadmap for hwpx-mcp-server.

AI-powered analysis · PDF + markdown · Delivered within 30 minutes

$99

Package Brief

Quick verdict, integration guide, cost projections, gotchas with workarounds, and alternatives comparison.

Delivered within 10 minutes

Score Monitoring

Get alerted when this package's AF, security, or reliability scores change significantly. Stay ahead of regressions.

Continuous monitoring

$3/mo

API endpoint ↗ Agent guide ↗ Report inaccuracy

Scores are editorial opinions as of 2026-03-30.