JinDaGe - Word Document Tools MCP Details

article

README

🚀 词工具 MCP 服务器

词工具 MCP 服务器实现了模型上下文协议（MCP），借助 AI 技术为用户提供强大的 Word 文档操作功能。通过该服务器，AI 应用程序能以自然语言交互的方式，轻松完成 Word 文档的创建、编辑与管理。

✨ 主要特性

完整实现 MCP 协议，为 AI 应用与 Word 文档交互提供坚实基础。
支持 Word 文档的创建和管理，让文档操作更加便捷。
可进行丰富文本内容操作，满足多样化的编辑需求。
能够创建和格式化表格，使数据展示更加清晰。
实现文档布局控制，让文档排版更加美观。
提供文档元数据管理功能，方便对文档信息进行维护。
支持实时文档状态监控，随时掌握文档动态。

📦 安装指南

临时安装

npx @puchunjie/doc-tools-mcp

全局安装

npm install -g @puchunjie/doc-tools-mcp

作为项目依赖安装

npm install @puchunjie/doc-tools-mcp

💻 使用示例

基础用法

启动 MCP 服务器

npx @puchunjie/doc-tools-mcp

服务器将默认在 8765 端口启动。

配置 AI 应用程序

配置您的 AI 应用程序（例如 Cursor、VSCode）以使用 MCP 服务器：

http://localhost:8765

高级用法

Cursor 集成

打开 Cursor 配置文件 ~/.cursor/mcp.json。
添加以下配置：

{
  "mcpServers": {
    "doc-tools-mcp": {
      "command": "npx",
      "args": [
        "@puchunjie/doc-tools-mcp"
      ]
    }
  }
}

或者用于本地开发版本：

{
  "mcpServers": {
    "doc-tools-mcp": {
      "command": "node",
      "args": [
        "/path/to/your/doc-tools-mcp/dist/mcp-server.js"
      ]
    }
  }
}

配置完成后，您可以使用自然语言操作 Word 文档：

"创建名为report.docx的新文档"
"在report.docx中添加标题'月度报告'"
"插入一个4x3的表格以包含销售数据"

VSCode 和其他支持 MCP 的应用程序

与其他支持 MCP 协议的工具集成步骤类似。具体的配置方法可以参考此处。

📚 详细文档

MCP 工具

该服务器提供以下 MCP 功能： | 功能 | 参数 | 说明 | | ---- | ---- | ---- | | create_document | filePath（必需）、title、author | 创建新的 Word 文档 | | open_document | filePath（必需） | 打开现有 Word 文档 | | add_paragraph | filePath（必需）、text（必需）、style、alignment | 在文档中添加段落 | | add_table | filePath（必需）、rows（必需）、cols（必需）、headers、data | 向文档中添加表格 | | search_and_replace | filePath（必需）、searchText（必需）、replaceText（必需）、matchCase | 在文档中查找并替换文本 | | set_page_margins | filePath（必需）、top、right、bottom、left | 设置文档页面边距 | | get_document_info | filePath（必需） | 获取文档元数据 |

开发相关

项目使用 Node.js 和 JavaScript 编写，适合熟悉该技术栈的开发者。
服务器的核心逻辑位于 server.js 文件中，负责处理不同的 MCP 命令。
每个功能模块（如创建文档、添加段落等）都独立实现，便于维护和扩展。

配置相关

服务器默认监听 8765 端口。如果需要更改端口，请修改 server.js 中的相应配置。
支持自定义插件系统，允许开发者扩展更多功能。具体方法请参考扩展文档。

示例

以下是一个简单的使用示例：

安装服务器：

npm install @puchunjie/doc-tools-mcp

启动服务器：

npx @puchunjie/doc-tools-mcp

在浏览器中访问 http://localhost:8765，即可看到提供的 API 接口。

🔧 技术细节

该服务器基于 Node.js 和 JavaScript 构建，核心逻辑集中在 server.js 文件中，通过独立实现各个功能模块，确保了系统的可维护性和扩展性。同时，服务器实现了完整的 MCP 协议，为 AI 应用与 Word 文档的交互提供了稳定的支持。

📄 许可证

本项目遵循 MIT 许可证，具体内容请参考LICENSE文件。

问题与支持

如遇问题，请访问GitHub 仓库查看文档或提交 ISSUE。我们有活跃的开发者社区为您提供帮助。

Word Document Tools