AI导哈

HWP文档处理MCP服务器

一个用于创建和编辑HWP文档的Model Context Protocol (MCP)服务器，支持文本插入、格式设置、表格管理，并与Claude Desktop集成实现自然语言文档编写。

  • by BAKJONGCHAN
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 bakjongchan/hwp-mcp

使用说明

HWP MCP（韩文文档处理MCP服务器）

用于创建韩文HWP文档的Model Context Protocol（MCP）服务器。

功能

  • 创建和编辑韩文（HWP）文档
  • 插入文本并设置格式
  • 创建和管理表格
  • 与Claude Desktop集成，使用自然语言创建文档

安装方法

1.存储库克隆

git clone https://github.com/BAKJONGCHAN/hwp-mcp.git
cd hwp-mcp

2.安装依赖性

pip install -r requirements.txt

3.Claude桌面设置

修改Claude Desktop的配置文件：

视窗: %APPDATA%\Claude\claude_desktop_config.json macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "hwp-mcp": {
      "command": "python",
      "args": ["C:\\Users\\[사용자명]\\Documents\\hwp-mcp\\hwp_mcp_stdio_server_fixed.py"],
      "cwd": "C:\\Users\\[사용자명]\\Documents\\hwp-mcp"
    }
  }
}

注意: [사용자명] 请将部分更改为实际用户名，并根据克隆的路径进行修改。

4.使用虚拟环境（建议）

# 가상환경 생성
python -m venv venv

# 가상환경 활성화 (Windows)
venv\Scripts\activate

# 가상환경 활성화 (macOS/Linux)
source venv/bin/activate

# 의존성 설치
pip install -r requirements.txt

如果您使用的是虚拟环境，请设置Claude Desktop：

{
  "mcpServers": {
    "hwp-mcp": {
      "command": "C:\\Users\\[사용자명]\\Documents\\hwp-mcp\\venv\\Scripts\\python.exe",
      "args": ["hwp_mcp_stdio_server_fixed.py"],
      "cwd": "C:\\Users\\[사용자명]\\Documents\\hwp-mcp"
    }
  }
}

使用方法

  1. 必须安装韩文（HWP）程序
  2. 重新启动Claude Desktop
  3. 您可以在与Claude对话的同时创建HWP文档。

示例命令

  • “请创建新的HWP文档”
  • “请把题目输入为‘报告书’”
  • “请给我做3x3票”
  • “请保存文件”

文件结构

  • hwp_mcp_stdio_server_fixed.py：主MCP服务器文件
  • requirements.txt：Python依赖包列表
  • INSTALL_MANUAL.md：详细安装指南
  • install_hwp_mcp_fixed.bat：Windows自动安装脚本

故障排除

详细的故障排除方法包括： 安装_手册.md 请参考文件。

许可证

MIT许可证

贡献

欢迎随时发布热点或全线请求！

相关 MCP