星战科技xingzhan.cloud
返回市场
硬件管理-MCP

硬件管理-MCP

作者：jkf87167 星标更新：2025-06-05
安装使用来源：spider==github.com

项目介绍

HWP-MCP (韩文 Model Context Protocol)

GitHub

HWP-MCP 是一个 Model Context Protocol (MCP) 服务器，它允许像 Claude 这样的AI模型控制韩文文字处理器 (HWP)。此项目为AI提供了自动创建、编辑和操作韩文文档的功能。

主要功能

  • 文档生成与管理：创建新文档、打开、保存等功能
  • 文本编辑：插入文本、设置字体、添加段落
  • 表格操作：创建表格、填充数据、设置单元格内容
  • 完成文档生成：基于模板自动生成报告和信函
  • 批处理操作：一次执行多个任务的批处理功能

系统需求

  • Windows 操作系统
  • 安装韩文 (HWP) 软件
  • Python 3.7 或更高版本
  • 必需的 Python 包（参见 requirements.txt）

安装方法

  1. 克隆存储库：
git clone https://github.com/jkf87/hwp-mcp.git
cd hwp-mcp
  1. 安装依赖项：
pip install -r requirements.txt
  1. （可选）安装 MCP 包：
pip install mcp

使用方法

与 Claude 一起使用

在 Claude 桌面设置文件中注册 HWP-MCP 服务器如下：

{
  "mcpServers": {
    "hwp": {
      "command": "python",
      "args": ["路径/hwp-mcp/hwp_mcp_stdio_server.py"]
    }
  }
}

主要功能示例

创建新文档

hwp_create()

插入文本

hwp_insert_text("输入您想要的文本。")

创建表格并输入数据

# 创建表格
hwp_insert_table(rows=5, cols=2)

# 填充表格数据
hwp_fill_table_with_data([
    ["月", "销售量"], 
    ["1月", "120"], 
    ["2月", "150"], 
    ["3月", "180"], 
    ["4月", "200"]
], has_header=True)

# 在表中填充连续数字
hwp_fill_column_numbers(start=1, end=10, column=1, from_first_cell=True)

保存文档

hwp_save("路径/文档名.hwp")

批处理操作示例

hwp_batch_operations([
    {"operation": "hwp_create"},
    {"operation": "hwp_insert_text", "params": {"text": "标题"}},
    {"operation": "hwp_set_font", "params": {"size": 20, "bold": True}},
    {"operation": "hwp_save", "params": {"path": "路径/文档名.hwp"}}
])

项目结构

hwp-mcp/
├── hwp_mcp_stdio_server.py  # 主服务器脚本
├── requirements.txt         # 依赖包列表
├── hwp-mcp-结构说明.md       # 项目结构说明文档
├── src/
│   ├── tools/
│   │   ├── hwp_controller.py  # 控制韩文的核心控制器
│   │   └── hwp_table_tools.py # 专门处理表格功能的模块
│   ├── utils/                 # 工具函数
│   └── __tests__/             # 测试模块
└── security_module/
    └── FilePathCheckerModuleExample.dll  # 安全模块

故障排除

安全模块相关问题

默认情况下，韩文程序在外部访问文件时会显示安全警告。为了绕过这一点，我们使用了 FilePathCheckerModuleExample.dll 模块。即使安全模块注册失败，功能仍然可以工作，但在打开/保存文件时可能会出现安全对话框。

韩文连接失败

如果韩文程序未运行，则可能无法建立连接。请确保韩文程序已安装且正常运行。

表格数据输入问题

在向表格输入数据时，光标位置有时会与预期不同，但当前版本已经解决了这个问题。现在可以准确地将数据输入到表格的所有单元格中。

更改日志

2025-03-27

  • 改进了表格创建和数据填充功能
    • 解决了表格嵌套的问题
    • 分离了表格创建和数据填充功能
    • 添加了在创建表格前检查当前光标位置的逻辑
    • 改进了仅在现有表格中填充数据的功能
  • 改进了项目管理
    • 添加了 .gitignore 文件（排除临时文件、缓存文件等）

2025-03-25

  • 改进了表格数据输入功能
    • 可以从第一个单元格开始准确地输入数据
    • 改进了选择单元格和设置光标位置的逻辑
    • 添加了在输入文本时保持光标位置的功能
  • 添加了专用表格工具模块 (hwp_table_tools.py)
  • 在 hwp_fill_column_numbers 函数中增加了 from_first_cell 选项

许可证

本项目根据 MIT 许可证发布。详情请参阅 LICENSE 文件。

如何贡献

  1. 报告问题或提出功能建议：使用 GitHub Issues。
  2. 提交代码贡献：提交包含更改的 Pull Request。

相关项目

联系方式

有关项目的问题，请通过 GitHub Issues 或 柯南老师 联系我们。