{"id":"airmang-hwpx-mcp-server","name":"hwpx-mcp-server","homepage":null,"repo_url":"https://github.com/airmang/hwpx-mcp-server","category":"ai-ml","subcategories":[],"tags":["mcp","python","hwpx","document-automation","local-files","ai-integration"],"what_it_does":"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.","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"],"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.","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)"],"af_score":64.0,"security_score":27.2,"reliability_score":36.2,"package_type":"mcp_server","discovery_source":["github"],"priority":"high","status":"evaluated","version_evaluated":null,"last_evaluated":"2026-03-30T15:25:06.542074+00:00","interface":{"has_rest_api":false,"has_graphql":false,"has_grpc":false,"has_mcp_server":true,"mcp_server_url":null,"has_sdk":false,"sdk_languages":[],"openapi_spec_url":null,"webhooks":false},"auth":{"methods":[],"oauth":false,"scopes":false,"notes":"No authentication mechanism is described in the README; the server appears intended for local use from trusted MCP clients."},"pricing":{"model":null,"free_tier_exists":false,"free_tier_limits":null,"paid_tiers":[],"requires_credit_card":false,"estimated_workload_costs":null,"notes":"Open-source (MIT) with local execution; operational costs depend on your environment/AI client."},"requirements":{"requires_signup":false,"requires_credit_card":false,"domain_verification":false,"data_residency":[],"compliance":[],"min_contract":null},"agent_readiness":{"af_score":64.0,"security_score":27.2,"reliability_score":36.2,"mcp_server_quality":78.0,"documentation_accuracy":75.0,"error_message_quality":0.0,"error_message_notes":null,"auth_complexity":100.0,"rate_limit_clarity":0.0,"tls_enforcement":10.0,"auth_strength":20.0,"scope_granularity":0.0,"dependency_hygiene":55.0,"secret_handling":60.0,"security_notes":"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.","uptime_documented":0.0,"version_stability":65.0,"breaking_changes_history":50.0,"error_recovery":30.0,"idempotency_support":"false","idempotency_notes":"Not documented. Many tools imply file mutations (edits/replacements), and idempotency behavior is not specified.","pagination_style":"none","retry_guidance_documented":false,"known_agent_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."]}}