🚀 词工具 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。我们有活跃的开发者社区为您提供帮助。