Hwpx MCP Server
MCP Server for HWPX (Korean Hangul) document editing - 135 tools (form-fill / style-palette / free-form modes + get_user_paths for Claude Desktop sandbox compatibility) for AI-powered document automation
Ask AI about Hwpx MCP Server
Powered by Claude ยท Grounded in docs
I know everything about Hwpx MCP Server. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
๐ hwpx-mcp-server
AI ์์ด์ ํธ๊ฐ HWPX ๋ฌธ์๋ฅผ ๋ฐ๋ก ์ฝ๊ณ , ์ฐพ๊ณ , ์์ ํ๊ฒ ๋ง๋๋ MCP ์๋ฒ
ํ๊ธ ์๋ํ๋ก์ธ์ ์์ด ยท ์์ ํ์ด์ฌ ยท ํฌ๋ก์ค ํ๋ซํผ
๐งฉ HWPX Stack (3์ข )
| ๊ณ์ธต | ๋ ํฌ | ์ญํ |
|---|---|---|
| ๐ฆ ๋ผ์ด๋ธ๋ฌ๋ฆฌ | python-hwpx | ์์ ํ์ด์ฌ HWPX ํ์ฑยทํธ์งยท์์ฑ ์ฝ์ด |
| ๐ MCP ์๋ฒ | hwpx-mcp-server | MCP ํด๋ผ์ด์ธํธ(Claude Desktop, VS Code ๋ฑ)์์ HWPX ์กฐ์ |
| ๐ฏ ์์ด์ ํธ ์คํฌ | hwpx-skill | ์์ด์ ํธ๊ฐ HWPX๋ฅผ ๋ฐ๋ก ์ฐ๊ฒ ํด์ฃผ๋ ๊ณต์ ์จ๋ณด๋ฉ ์คํฌ |
hwpx-mcp-server๋ ๋ชจ๋ธ ์ปจํ ์คํธ ํ๋กํ ์ฝ(MCP) ํ์ค์ ๋ฐ๋ฅด๋ ์๋ฒ๋ก, python-hwpx ๊ธฐ๋ฐ์์ HWPX ๋ฌธ์์ ์ด๋ ยท ๊ฒ์ ยท ํธ์ง ยท ์ถ์ถ์ AI ํด๋ผ์ด์ธํธ์์ ์ง์ ์ํํ ์ ์๊ฒ ํฉ๋๋ค.
์ฐธ๊ณ ์ด ์๋ฒ๋ Open XML ๊ธฐ๋ฐ
.hwpxํฌ๋งท์ ์ง์ํฉ๋๋ค. ๋ฐ์ด๋๋ฆฌ.hwpํฌ๋งท์ ์ง์ ํธ์ง ๋์์ด ์๋๋๋ค.
์ด ์๋ฒ๊ฐ ๋ฐ๋ก ํด๊ฒฐํ๋ ์ผ
- Claude Desktop, VS Code, Gemini CLI ๊ฐ์ MCP ํด๋ผ์ด์ธํธ์์ HWPX๋ฅผ ๋ฐ๋ก ์ฝ๊ธฐ
- ๋ณต์ฌ๋ณธ์ ๋ง๋ ๋ค ์์ ํ๊ฒ ๊ฒ์ยท์นํยทํ ํธ์งยท๋ฌธ๋จ ์ถ๊ฐ ์ํ
- ๋ฌธ์ ๊ฐ์, ํ ๋งต, ํจํค์ง ๊ตฌ์กฐ๋ฅผ AI๊ฐ ์ง์ ์กฐํํ๊ณ ํ์ ์์ ์ผ๋ก ์ฐ๊ฒฐ
- ํ๊ธ ์๋ํ๋ก์ธ์ ์์ด ์๋ฒยทCIยท๋ก์ปฌ ๊ฐ๋ฐ ํ๊ฒฝ์์ ๊ฐ์ ํ๋ฆ ์ ์ง
- ๊ณ ๊ธ ๋ชจ๋์์ ๊ฒ์ฆ, package inspection, edit planning๊น์ง ํ์ฅ
Claude Desktop 5๋ถ ์ฐ๊ฒฐ
์๋ ์ค์ ํ๋๋ง ๋ฃ์ผ๋ฉด Claude Desktop์์ hwpx MCP ์๋ฒ๋ฅผ ๋ฐ๋ก ์ก๋๋ค.
{
"mcpServers": {
"hwpx": {
"command": "uvx",
"args": ["hwpx-mcp-server"]
}
}
}
Screenshot placeholder: Claude Desktop ์ค์ ํ๋ฉด์์
hwpx์๋ฒ๊ฐ ํ์ฑํ๋ ์ฅ๋ฉด์ ์ฌ๊ธฐ์ ๋ฃ์ ์์ .
์ ํ์ํ๊ฐ?
๊ตญ๋ด ๊ณต๊ณต๊ธฐ๊ดยทํ๊ตยท๊ธฐ์ ์์๋ ํ๊ธ ๋ฌธ์ ๊ธฐ๋ฐ ์ ๋ฌด๊ฐ ๋ง์ง๋ง, ์๋ํ๋ ์ค๋ซ๋์ ์ด์์ฒด์ ์ ํ๋ก๊ทธ๋จ์ ํฌ๊ฒ ์์กดํ์ต๋๋ค.
hwpx-mcp-server๋ ์ด ์ ์ฝ์ ์ค์ด๋ ๋ฐ ์ด์ ์ ๋ก๋๋ค.
- โ ์ด์์ฒด์ ๋ฌด๊ด โ Windows, macOS, Linux์์ ๋์
- โ ํ๊ธ ์๋ํ๋ก์ธ์ ๋ถํ์ โ ์์ ํ์ด์ฌ ๊ธฐ๋ฐ ์ฒ๋ฆฌ
- โ AI ์ฐ๋ ์ค์ฌ โ Claude Desktop, VS Code, Gemini CLI ๋ฑ MCP ํด๋ผ์ด์ธํธ์ ์ง์ ์ฐ๊ฒฐ
- โ ๋ฌธ์ ํธ์ง์ ๋๊ตฌ ํธ์ถ๋ก ํ์คํ โ ์ฝ๊ธฐ, ํธ์ง, ๋ณต์ , ๊ฒ์ฆ์ MCP ๋๊ตฌ ์งํฉ์ผ๋ก ๋ ธ์ถ
- โ ์ค์ ์์ ํ๋ฆ์ ๋ง์ถ ์ค๊ณ โ read, copy, edit, inspect, validate๋ฅผ ํ ์๋ฒ ํ๋ฉด์ผ๋ก ์ ๋ฆฌ
- โ
์ผ๊ด๋ ํธ์ถ ๋ฐฉ์ โ ๋๊ตฌ ํธ์ถ๋ง๋ค
filename์ ๋ช ์ํ๋ stateless ๊ตฌ์กฐ
์ฌ์ฉ ์ฌ๋ก
- ์ค์ ์ฌ์ฉ ์ฌ๋ก:
docs/use-cases.md - ์ข
ํฉ ํ
์คํธ ๋ฆฌํฌํธ:
tests/hwpx_mcp_report_updated.md
๋น ๋ฅธ ์์
1. ์ค์น ๋ฐ ์คํ
uv ๊ธฐ์ค:
uvx hwpx-mcp-server
๋๋ pip ์ค์น ํ ์คํ:
pip install hwpx-mcp-server
hwpx-mcp-server
์๊ตฌ ์ฌํญ:
Python >= 3.10python-hwpx >= 2.6
ํ์ฌ ์ ์ฅ์ ๊ธฐ์ค ๊ฒ์ฆ ๋ฒ์ ์ python-hwpx 2.9.0์
๋๋ค (2026-04-15 ๊ฒ์ฆ).
์ต์ ์ง์ ๋ฒ์ ์ python-hwpx >= 2.6์
๋๋ค.
2. MCP ํด๋ผ์ด์ธํธ ์ค์
Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"hwpx": {
"command": "uvx",
"args": ["hwpx-mcp-server"]
}
}
}
Gemini CLI
~/.gemini/settings.json
{
"mcpServers": {
"hwpx": {
"command": "uvx",
"args": ["hwpx-mcp-server"]
}
}
}
VS Code
.vscode/mcp.json
{
"servers": {
"hwpx": {
"command": "uvx",
"args": ["hwpx-mcp-server"]
}
}
}
Cursor / Windsurf
๊ฐ ์๋ํฐ์ MCP ์ค์ ํ์ผ์ ๊ฐ์ ๋ธ๋ก์ ์ถ๊ฐํ๋ฉด ๋ฉ๋๋ค.
{
"mcpServers": {
"hwpx": {
"command": "uvx",
"args": ["hwpx-mcp-server"]
}
}
}
์์ ๋ณ ๋น ๋ฅธ ๊ฒฝ๋ก
์ฒ์๋ถํฐ ๋ชจ๋ ๋๊ตฌ๋ฅผ ์ธ์ธ ํ์๋ ์๋ค. ๋ณดํต์ ์๋ ์ธ ํ๋ฆ ์ค ํ๋๋ก ์์ํ๋ฉด ๋๋ค.
1. ์ฝ๊ธฐ ์ ์ฉ์ผ๋ก ๋ฌธ์๋ฅผ ํ์ ํ ๋
get_document_infoget_document_outline๋๋get_document_textfind_text,get_table_text,get_table_map๊ฐ์ ์ฝ๊ธฐ ๋๊ตฌ๋ก ํ์ํ ๋ถ๋ถ๋ง ๋ ๋ณธ๋ค.
์ด ํ๋ฆ์ ์๋ณธ์ ์ ์ฅํ์ง ์๋๋ค.
2. ์์ ํ๊ฒ ์์ ํ ๋
copy_document๋ก ์์ ์ฉ ์ฌ๋ณธ์ ๋ง๋ ๋ค.- ์ฝ๊ธฐ ๋๊ตฌ๋ก ์์ ๋์์ ๋ค์ ํ์ธํ๋ค.
search_and_replace,batch_replace,set_table_cell_text,add_paragraph๊ฐ์ ๊ฐ์ฅ ์์ ๋ณ๊ฒฝ ๋๊ตฌ๋ง ์ด๋ค.- ์์ ํ ๋ค์ ์ฝ๊ธฐ ๋๊ตฌ๋ก ๊ฒฐ๊ณผ๋ฅผ ํ์ธํ๋ค.
- ๋ฉํ์ด๋ handoff๊ฐ ํ์ํ๋ฉด ๊ฒํ ๊ฐ ๋๋ ๋ณต์ฌ๋ณธ ํ์ผ์ ๊ทธ๋๋ก ๋๊ธด๋ค.
ํต์ฌ์ copy first, smallest edit, re-read after edits๋ค.
3. ๊ตฌ์กฐ ์ ๊ฒ๊ณผ ๊ฒ์ฆ์ด ๋ชฉ์ ์ผ ๋
- MCP ์ค์ ์์
HWPX_MCP_ADVANCED=1 package_parts,package_get_xml,package_get_text๋ก ๋ด๋ถ ํํธ๋ฅผ ๋ณธ๋ค.validate_structure,lint_text_conventions,plan_edit,preview_edit๋ ๊ธฐ๋ณธ ํธ์ง ํ๋ฆ๊ณผ ์์ง ์๊ณ ์ ๊ฒ/๊ฒ์ฆ ๋จ๊ณ์์๋ง ์ฌ์ฉํ๋ค.
์์ ํ ์ฌ์ฉ ์์น
์ด ์๋ฒ์ ๊ณต๊ฐ ํ๋ฉด์ ํ์ฌ README์ ์ ํ MCP ๋๊ตฌ ์งํฉ์ด๋ค. ์ํฌํ๋ก ๋ฌธ์๋ ์คํฌ ์์๋ ์ด ๋๊ตฌ๋ค์ ์กฐํฉํ๋ ์ฌ์ฉ ํจํด์ด์ง, ๋ณ๋์ ์ public tool ๊ณ์ฝ์ด ์๋๋ค.
์ค์ ์์๋ ์๋ ์์๊ฐ ๊ฐ์ฅ ์์ ํ๋ค.
- ๋จผ์
get_document_info,get_document_text,find_text๊ฐ์ ์ฝ๊ธฐ ๋๊ตฌ๋ก ๋ฌธ์๋ฅผ ํ์ ํ๋ค. - ์์ ์ ๊ฒฐ๊ณผ๋ฌผ์ ๋ณด์กดํด์ผ ํ๋ฉด
copy_document๋ฅผ ๋จผ์ ํธ์ถํ๋ค. - ์์ ๋๊ตฌ๋ ํธ์ถ ์ฆ์ ์ ์ฅ๋๋ฏ๋ก, ๊ฒํ ์ฉ ๊ฒฝ๋ก๊ฐ ํ์ํ๋ฉด ์๋ณธ ๋์ ๋ณต์ฌ๋ณธ์์ ์์ ํ๋ค.
- ๊ฒฐ๊ณผ๋ฌผ์ ๋ฐ๋ก ๋๊ฒจ์ผ ํ๋ฉด ๊ฒํ ๊ฐ ๋๋ ๋ณต์ฌ๋ณธ ํ์ผ์ handoff ๊ฒฝ๊ณ๋ก ์ฌ์ฉํ๋ค.
- package inspection, edit planning, validation์
HWPX_MCP_ADVANCED=1์ผ ๋๋ง ์ฐ๊ณ , ๊ธฐ๋ณธ ํ๋ฆ๊ณผ ์์ด ์ฐ์ง ์๋๋ค.
์งง๊ฒ ๋งํ๋ฉด:
- read first
- copy before risky edits
- mutating tools persist immediately
- explicit handoff uses the reviewed copy
- advanced mode๋ ์ ๊ฒ/๊ฒ์ฆ์ฉ์ผ๋ก ๋ถ๋ฆฌ
๋๊ตฌ ๋์ ๋น ๋ฅธ ๊ฐ๊ฐ
| ๊ตฌ๋ถ | ๋ํ ๋๊ตฌ | ํน์ง |
|---|---|---|
| ํ์ผ ๊ธฐ๋ฐ ์ฝ๊ธฐ ์ ์ฉ | get_document_info, get_document_text, get_paragraph_text, get_paragraphs_text, find_text, get_table_text, get_table_map, find_cell_by_label, list_styles, list_available_documents | ๊ธฐ์กด .hwpx ํ์ผ์ ์ฝ๊ฑฐ๋ ํ์๋ง ํ๋ค. ์ ์ฅํ์ง ์๋๋ค. |
| ํ์ผ ๊ธฐ๋ฐ ์ฆ์ ์ ์ฅ ํธ์ง | create_document, search_and_replace, batch_replace, add_heading, add_paragraph, insert_paragraph, delete_paragraph, add_table, fill_by_path, set_table_cell_text, add_page_break, add_memo, remove_memo, format_text, create_custom_style, merge_table_cells, split_table_cell, format_table | ํธ์ถ ๊ฒฐ๊ณผ๊ฐ ๊ณง ๋์ ํ์ผ ๋ณ๊ฒฝ์ด๋ค. ๊ฒํ ์ฉ์ด๋ฉด ๋จผ์ ๋ณต์ฌ๋ณธ์์ ์์ ํ๋ค. |
| ๋ณต์ / handoff ๊ฒฝ๊ณ | copy_document | ์๋ณธ ๋ณดํธ์ reviewable working copy ๋ถ๋ฆฌ์ ์ด๋ค. ํ์ฌ FastMCP surface์๋ ๋ณ๋ public save / save_as tool์ด ์๋ค. |
| payload/url ๊ธฐ๋ฐ ์ถ์ถ | hwpx_to_markdown, hwpx_to_html, hwpx_extract_json | ํ์ผ๋ช ์ ์ง์ ์์ ํ์ง ์๋๋ค. HWPX payload ๋๋ URL์ ์ฝ์ด ๋ณํ ๊ฒฐ๊ณผ๋ง ๋๋ ค์ค๋ค. |
| ๊ณ ๊ธ ์ ๊ฒ/๊ฒ์ฆ | package_parts, package_get_xml, package_get_text, object_find_by_tag, object_find_by_attr, plan_edit, preview_edit, apply_edit, validate_structure, lint_text_conventions | HWPX_MCP_ADVANCED=1์ผ ๋๋ง ํ์ฑํํ๋ค. package/๊ตฌ์กฐ ์ ๊ฒ์ฉ์ด๋ค. |
์ฃผ์ ๊ธฐ๋ฅ
๊ธฐ๋ณธ ๋ชจ๋์์ ์ฃผ์ HWPX ํธ์ง ๋๊ตฌ๋ฅผ ์ ๊ณตํ๋ฉฐ, ๊ณ ๊ธ ๋ชจ๋(HWPX_MCP_ADVANCED=1)์์๋ ์ ๊ฒยท๊ฒ์ฆ์ฉ ๋๊ตฌ๊ฐ ์ถ๊ฐ๋ก ํ์ฑํ๋ฉ๋๋ค.
๐ ์ฝ๊ธฐ ๋ฐ ํ์
| ๋๊ตฌ | ์ค๋ช |
|---|---|
get_document_info | ๋ฌธ์ ๋ฉํ๋ฐ์ดํฐ, ์น์ , ๋ฌธ๋จ, ํ ๊ฐ์ ์กฐํ |
get_document_text | ๋ฌธ์ ์ ์ฒด ํ
์คํธ ์ถ์ถ (max_chars ์ง์) |
get_document_outline | ์ ๋ชฉ๊ณผ ๊ฐ์ ๊ตฌ์กฐ ์ถ์ถ |
get_paragraph_text | ํน์ ๋ฌธ๋จ ํ ์คํธ ์กฐํ |
get_paragraphs_text | ๋ฌธ๋จ ๋ฒ์ ์กฐํ |
list_available_documents | ํด๋ ์์ .hwpx ํ์ผ ๋ชฉ๋ก ์กฐํ |
๐ ๊ฒ์ ๋ฐ ์นํ
find_text๋ ์ฝ๊ธฐ ์ ์ฉ์ด๊ณ , search_and_replace / batch_replace๋ ํธ์ถ ์ฆ์ ์ ์ฅ๋๋ค.
| ๋๊ตฌ | ์ค๋ช |
|---|---|
find_text | ํค์๋ ๊ฒ์๊ณผ ์ฃผ๋ณ ๋ฌธ๋งฅ ๋ฐํ |
search_and_replace | ๋จ์ผ ํ ์คํธ ์นํ |
batch_replace | ์ฌ๋ฌ ์นํ ์์ ์ผ๊ด ์คํ |
โ๏ธ ๋ฌธ์ ํธ์ง
์ด ์นดํ
๊ณ ๋ฆฌ์ ๋๊ตฌ๋ ๋์ฒด๋ก ๋์ ํ์ผ์ ์ฆ์ ๋ฐ์๋๋ค. ๊ตฌ์กฐ ๋ณ๊ฒฝ ์ ์๋ copy_document๋ก ์์
์ฉ ์ฌ๋ณธ์ ๋ง๋ค๊ณ , handoff๋ ๊ฒํ ๊ฐ ๋๋ ๋ณต์ฌ๋ณธ ํ์ผ ๊ธฐ์ค์ผ๋ก ์ก๋ ํธ์ด ์์ ํ๋ค.
| ๋๊ตฌ | ์ค๋ช |
|---|---|
add_heading | ์ ๋ชฉ(ํค๋ฉ) ๋ฌธ๋จ ์ถ๊ฐ |
add_paragraph / insert_paragraph / delete_paragraph | ๋ฌธ๋จ ์ถ๊ฐ, ์ฝ์ , ์ญ์ |
add_page_break | ํ์ด์ง ๋๋๊ธฐ ์ถ๊ฐ |
add_memo / remove_memo | ๋ฉ๋ชจ ์ถ๊ฐ, ์ ๊ฑฐ |
๐พ ๋ณต์
์ด ์นดํ ๊ณ ๋ฆฌ๋ ์์ ์ํฌํ๋ก์ ์์ ์ฅ์น๋ค. ์๋ณธ ๋ณดํธ์ reviewable working copy ๋ถ๋ฆฌ์ ์ด๋ค.
| ๋๊ตฌ | ์ค๋ช |
|---|---|
copy_document | ์๋ณธ์ ๊ฑด๋๋ฆฌ๊ธฐ ์ ์ ์์ ์ฉ ์ฌ๋ณธ ์์ฑ |
๐ ํ ํธ์ง
get_table_text, get_table_map, find_cell_by_label๋ ์ฝ๊ธฐ ์ ์ฉ์ด๋ค. fill_by_path, set_table_cell_text, merge_table_cells, split_table_cell, format_table์ ํธ์ถ ์ฆ์ ์ ์ฅ๋๋ค.
| ๋๊ตฌ | ์ค๋ช |
|---|---|
add_table / get_table_text | ํ ์์ฑ, ์กฐํ |
get_table_map | ํ๊ฐ ๋ง์ ๋ฌธ์์์ ํ ์์น, ํฌ๊ธฐ, ํค๋ ๋ฌธ๋งฅ์ ๋น ๋ฅด๊ฒ ํ์ |
find_cell_by_label | ํ๊ตญ์ด ์์/ํ ํ๋ฆฟ์์ ๋ผ๋ฒจ ์ ๊ธฐ์ค์ผ๋ก ์ ๋ ฅ ๋์ ์ ์ฐพ๊ธฐ |
fill_by_path | ์ฑ๋ช
> right, ์์ > right, ํฉ๊ณ > down > right ๊ฐ์ ๊ฒฝ๋ก ๊ตฌ๋ฌธ์ผ๋ก ์
์ฑ์ฐ๊ธฐ |
set_table_cell_text | ์ ํ ์คํธ ์์ |
merge_table_cells / split_table_cell | ์ ๋ณํฉ, ๋ถํ |
format_table | ํ ํค๋ ๋ฑ ๊ธฐ๋ณธ ์์ ์ ์ฉ |
๋ณ๊ฒฝ ๋๊ตฌ๋ ํธ์ถ ์ ์ฆ์ ์ ์ฅ๋ฉ๋๋ค. ๊ฒํ ์ฉ ์ฌ๋ณธ์ด ํ์ํ๋ฉด copy_document๋ฅผ ๋จผ์ ์ฌ์ฉํ๊ณ , ๋ฉํ๋ณธ์ ๊ฒํ ๊ฐ ๋๋ ๋ณต์ฌ๋ณธ ํ์ผ์ ๊ธฐ์ค์ผ๋ก ๊ด๋ฆฌํ์ธ์.
๐จ ์์ ๋ฐ ์คํ์ผ
list_styles๋ ์ฝ๊ธฐ ์ ์ฉ์ด๋ค. format_text, create_custom_style์ ๋ฌธ์๋ฅผ ์ง์ ๊ฐฑ์ ํ๋ค.
| ๋๊ตฌ | ์ค๋ช |
|---|---|
format_text | ํ ์คํธ ๋ฒ์ ์์ ์ ์ฉ |
create_custom_style | ์ปค์คํ ์คํ์ผ ์์ฑ |
list_styles | ๋ฌธ์ ์คํ์ผ ๋ชฉ๋ก ์กฐํ |
์คํ์ผ ์ฐธ์กฐ ํ: add_paragraph(..., style=...)์ insert_paragraph(..., style=...)๋ list_styles์ id, create_custom_style์ด ๋ฐํํ๋ style_id, ์คํ์ผ ์ด๋ฆ์ ๋ชจ๋ ๋ฐ์ ์ ์์ต๋๋ค.
๐ค ์ถ์ถ
์ด ์นดํ ๊ณ ๋ฆฌ๋ filename ๊ธฐ๋ฐ ํธ์ง ๋๊ตฌ๊ฐ ์๋๋ค. HWPX payload ๋๋ URL์ ์ฝ์ด ๋ณํ ๊ฒฐ๊ณผ๋ฅผ ๋ฐํํ๋ค.
| ๋๊ตฌ | ์ค๋ช |
|---|---|
hwpx_to_markdown | HWPX ๋ฌธ์๋ฅผ Markdown์ผ๋ก ๋ณํ |
hwpx_to_html | HWPX ๋ฌธ์๋ฅผ HTML๋ก ๋ณํ |
hwpx_extract_json | HWPX ๋ฌธ์๋ฅผ ๊ตฌ์กฐํ๋ JSON์ผ๋ก ์ถ์ถ |
๐ฌ ๊ณ ๊ธ ๋๊ตฌ
HWPX_MCP_ADVANCED=1์ผ ๋ ํ์ฑํ:
| ๋๊ตฌ | ์ค๋ช |
|---|---|
package_parts | OPC ํํธ ๋ชฉ๋ก ์กฐํ |
package_get_xml / package_get_text | ํํธ XML ๋๋ ํ ์คํธ ์กฐํ |
object_find_by_tag / object_find_by_attr | XML ์์ ๊ฒ์ |
plan_edit / preview_edit / apply_edit | ํธ์ง ๊ณํ, ๋ฏธ๋ฆฌ๋ณด๊ธฐ, ์ ์ฉ |
validate_structure / lint_text_conventions | ๊ตฌ์กฐ ๊ฒ์ฆ, ํ ์คํธ ๊ท์น ์ ๊ฒ |
ํ๊ฒฝ ๋ณ์
| ๋ณ์ | ์ค๋ช | ๊ธฐ๋ณธ๊ฐ |
|---|---|---|
HWPX_MCP_MAX_CHARS | ํ ์คํธ ๋ฐํ ๋๊ตฌ ๊ธฐ๋ณธ ์ต๋ ๊ธธ์ด | 10000 |
HWPX_MCP_AUTOBACKUP | 1์ด๋ฉด ์ ์ฅ ์ .bak ๋ฐฑ์
์์ฑ | 1 |
HWPX_MCP_ADVANCED | 1์ด๋ฉด ๊ณ ๊ธ ๋๊ตฌ ํ์ฑํ | 0 |
LOG_LEVEL | ๋ก๊ทธ ๋ ๋ฒจ | INFO |
ํ๊ฒฝ ๋ณ์ ํฌํจ MCP ์ค์ ์์:
{
"mcpServers": {
"hwpx": {
"command": "uvx",
"args": ["hwpx-mcp-server"],
"env": {
"HWPX_MCP_MAX_CHARS": "12000",
"HWPX_MCP_AUTOBACKUP": "1",
"HWPX_MCP_ADVANCED": "0",
"LOG_LEVEL": "INFO"
}
}
}
}
ํ ์คํธ
# ํ
์คํธ ์์กด์ฑ ์ค์น
python -m pip install -e ".[test]"
# ์ ์ฒด ํ
์คํธ
python -m pytest -q
์ถ๊ฐ ์ฐธ๊ณ :
- ์ฌ์ฉ ์ฌ๋ก:
docs/use-cases.md - ์ข
ํฉ ๋ฆฌํฌํธ:
tests/hwpx_mcp_report_updated.md - ์คํฌ ๊ธฐ๋ฐ ์ํฌํ๋ก:
docs/skill-first-workflows.md
License
Apache License 2.0. See LICENSE and NOTICE.
์์ฑ์
๊ณ ๊ทํ โ ๊ด๊ต๊ณ ๋ฑํ๊ต ์ ๋ณดยท์ปดํจํฐ ๊ต์ฌ
- ์ด๋ฉ์ผ: kokyuhyun@hotmail.com
- GitHub: @airmang
