Doc Tools Mcp

Word Tools MCP 服务

一个提供 AI 驱动的 Word 文档操作功能的模型上下文协议（MCP）服务。此服务实现了 MCP 协议，使 AI 应用能够通过自然语言交互创建、编辑和管理 Word 文档。

功能

• 完整实现 MCP 协议
• Word 文档的创建和管理
• 富文本内容操作
• 表格创建和格式设置
• 文档布局控制
• 文档元数据管理
• 实时监控文档状态

先决条件

• Node.js 14 或更高版本
• Microsoft Word（可选，用于高级功能）

安装

npx @puchunjie/doc-tools-mcp

或全局安装：

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

作为项目依赖项使用：

npm install @puchunjie/doc-tools-mcp

使用方法

1. 启动 MCP 服务：

npx @puchunjie/doc-tools-mcp

2. 服务默认在端口 8765 上启动

3. 配置 AI 应用（例如 Cursor、VSCode）以使用 MCP 服务：

   http://localhost:8765
   

MCP 工具

此服务提供以下 MCP 函数：

• create_document - 创建新的 Word 文档

  • 参数：filePath（必需）、title、author

• open_document - 打开现有的 Word 文档

  • 参数：filePath（必需）

• 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（必需）

与 AI 应用集成

Cursor

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

{
  "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 文档：

"Create a new document named report.docx"
"Add a heading 'Monthly Report' to report.docx"
"Insert a 4x3 table with sales data"

VSCode 和其他兼容 MCP 的工具

其他支持 MCP 协议的工具也可采用类似的集成步骤。有关 MCP 服务的具体配置步骤，请参阅相应工具的文档。

开发

要扩展或修改此 MCP 服务：

1. 克隆代码库：

git clone <repository-url>
cd doc-tools-mcp

2. 安装依赖项：

npm install

3. 在开发模式下启动：

npm run start

4. 构建生产版本：

npm run build

添加新的 MCP 函数

1. 在 src/services/DocumentService.ts 中添加新方法
2. 在 src/mcp-server.ts 中注册新函数
3. 根据需要更新类型定义

配置

• 默认端口：8765（可配置）
• 支持的文件类型：.docx
• 所有文件路径都应为绝对路径，或相对于当前工作目录的路径

许可证

MIT

支持

如果你遇到任何问题或有改进建议，请在我们的 GitHub 代码库中提交 issue。