项目简介

Word MCP Server 是一个实现了 Model Context Protocol (MCP) 的服务器,旨在为 AI 应用提供操作 Word 文档的能力。通过此服务器,AI 应用可以使用自然语言指令创建、编辑和管理 Word 文档,例如添加段落、表格、查找替换文本、设置页面边距以及获取文档信息等。

主要功能点

  • Word文档操作: 支持创建、打开、编辑和保存 Word 文档 (.docx 格式)。
  • 内容编辑: 允许添加和修改文档中的段落、表格、文本内容。
  • 格式控制: 支持设置段落样式、对齐方式、页面边距等文档格式。
  • 元数据管理: 可以获取文档的标题、作者、关键词等元数据信息。
  • MCP协议支持: 完全实现了 MCP 协议,可以与任何兼容 MCP 协议的客户端(如 Cursor, VSCode 等)集成。

安装步骤

  1. 确保已安装 Node.js 14 或更高版本。

  2. 使用 npm 或 npx 命令安装 '@puchunjie/doc-tools-mcp' 包:

    npx @puchunjie/doc-tools-mcp

    或者全局安装:

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

服务器配置

对于 MCP 客户端(例如 Cursor 或 VSCode),您需要配置 MCP 服务器的启动命令。以下是一个配置示例,用于 '~/.cursor/mcp.json' 文件或 VSCode 等客户端的 MCP 服务器配置:

{
  "mcpServers": {
    "doc-tools-mcp": {
      "command": "npx",
      "args": [
        "@puchunjie/doc-tools-mcp"
      ]
      // "command": "启动服务器的命令,这里使用 npx"
      // "args": "命令参数,这里指定要运行的 npm 包"
    }
  }
}

配置说明:

  • '"server name"': 'doc-tools-mcp' (服务器名称,可以自定义)
  • '"command"': 'npx' (通常使用 npx 或 npm 启动,如果全局安装可以使用包名直接运行)
  • '"args"': '["@puchunjie/doc-tools-mcp"]' (运行 '@puchunjie/doc-tools-mcp' 包作为服务器)

基本使用方法

  1. 启动 MCP 服务器:根据安装方式,在终端中运行 'npx @puchunjie/doc-tools-mcp' 或全局安装后的包名命令。服务器默认在 'http://localhost:8765' 运行 (stdio 传输模式,无需指定端口)。
  2. 在兼容 MCP 协议的 AI 应用(如 Cursor, VSCode)中配置并连接到 Word MCP Server。
  3. 使用自然语言指令,例如在 Cursor 中输入:
    • '"Create a new document named report.docx"' (创建一个名为 report.docx 的新文档)
    • '"Add a heading 'Monthly Report' to report.docx"' (在 report.docx 中添加标题 'Monthly Report')
    • '"Insert a 4x3 table with sales data in report.docx"' (在 report.docx 中插入一个 4x3 的表格)

AI 应用将通过 MCP 协议与 Word MCP Server 通信,执行文档操作。

信息

分类

生产力应用