Word文档AI处理服务

一个基于MCP协议的AI驱动Word文档处理服务,支持通过自然语言交互创建、编辑和管理Word文档。

  • by puchunjie
  • TypeScript
  • 本地部署
  • 10 星标
  • 更新于
在 GitHub 查看 puchunjie/doc-tools-mcp

使用说明

Word工具MCP服务器

一种模型上下文协议(MCP)服务器,提供人工智能驱动的Word文档操作功能。此服务器实现了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
  1. 默认情况下,服务器将在端口8765上启动

  2. 配置您的AI应用程序(例如Cursor、VSCode)以使用MCP服务器:

    http://localhost:8765
    

MCP工具

服务器提供以下MCP功能:

  • create_document -创建新的Word文档

    • 参数:文件路径(必填)、标题、作者
  • open_document -打开现有的Word文档

    • 参数:filePath(必填)
  • add_paragraph -在文档中添加一段

    • 参数:文件路径(必需)、文本(必需),样式,对齐方式
  • add_table -在文档中添加表格

    • 参数:filePath(必需)、行(必需)和列(必需),标头,数据
  • search_and_replace -查找并替换文档中的文本

    • 参数:filePath(必需),searchText(必需)
  • set_page_margins -设置文档页边距

    • 参数:filePath(必填),上、右、下、左
  • get_document_info -获取文档元数据

    • 参数:filePath(必填)

与AI应用程序集成

光标

  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
  1. 安装依赖项:
npm install
  1. 以开发模式启动:
npm run start
  1. 生产建设:
npm run build

添加新的MCP功能

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

配置

  • 默认端口:8765(可配置)
  • 支持的文件类型:.docx
  • 所有文件路径都应该是绝对路径或相对于当前工作目录的路径

许可证

麻省理工学院

支持

如果您遇到任何问题或有改进建议,请在我们的GitHub存储库上提交问题。