
Word Tools MCP Server

2025.03.26
5
TypeScriptWord 文档操作AI 驱动开发效率内容生成
Word Tools MCP Server 是一个基于 Model Context Protocol (MCP) 的服务,提供 AI 驱动的 Word 文档操作能力。该服务通过 MCP 协议实现,允许 AI 应用程序通过自然语言交互创建、编辑和管理 Word 文档。
View on GitHub
Overview
基本能力
产品定位
Word Tools MCP Server 是一个专注于 Word 文档操作的 MCP 服务,旨在通过 AI 技术简化文档的创建、编辑和管理流程。
核心功能
- 完整的 MCP 协议实现
- Word 文档的创建和管理
- 富文本内容操作
- 表格创建和格式化
- 文档布局控制
- 文档元数据管理
- 实时文档状态监控
适用场景
- AI 应用程序需要自动化生成 Word 文档
- 开发人员需要集成 Word 文档操作功能到其应用中
- 需要批量处理或自动化 Word 文档的场景
MCP 工具列表
create_document
- 创建新的 Word 文档open_document
- 打开现有的 Word 文档add_paragraph
- 向文档添加段落add_table
- 向文档添加表格search_and_replace
- 在文档中查找和替换文本set_page_margins
- 设置文档页边距get_document_info
- 获取文档元数据
常见问题解答
- 默认端口为 8765,可配置
- 支持的文件类型为 .docx
- 所有文件路径应为绝对路径或相对于当前工作目录的路径
使用教程
使用依赖
- Node.js 14 或更高版本
- Microsoft 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 应用程序(如 Cursor、VSCode)使用 MCP 服务器:
http://localhost:8765
集成 AI 应用程序
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"
]
}
}
}
开发
- 克隆仓库:
git clone <repository-url>
cd doc-tools-mcp
- 安装依赖:
npm install
- 开发模式启动:
npm run start
- 生产构建:
npm run build
添加新的 MCP 功能
- 在
src/services/DocumentService.ts
中添加新方法 - 在
src/mcp-server.ts
中注册新功能 - 根据需要更新类型定义