文档编辑工具

WordEX MCP是一款直接在GitHub Copilot中读写编辑Word、Excel、PDF和PowerPoint文件的工具,无需复制粘贴。

  • by Sahith59
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 Sahith59/WordEX-MCP

使用说明

WordEX MCP

Read, write, and edit Word, Excel, PDF & PowerPoint files directly from GitHub Copilot — with zero copy-paste.

Works with · GitHub Copilot · Claude Desktop · Cursor · Windsurf · Continue.dev


🔒 100%本地和私人

任何数据都不会离开你的机器。没有API密钥。没有云。没有遥测。专为处理敏感公司文件的团队而设计。


它解决的问题

如果没有WordEX,每个AI辅助的文档任务看起来都是这样的:

  1. 让AI生成内容
  2. 手动复制输出
  3. 打开Word/Excel/AAcrobat
  4. 粘贴并重新格式化
  5. 保存

使用WordEX:

Read ~/docs/api-tracker.xlsx and summarise the Status column
Create ~/docs/sprint-23.docx documenting my recent git changes
Extract all tables from ~/contracts/agreement.pdf
Read my pitch deck at ~/Presentations/Q4.pptx and give me key takeaways
OCR the scanned receipt at ~/Desktop/receipt.png

快速开始

npx wordex-mcp init

就是这样。这个命令可以检测您计算机上的每个MCP兼容编辑器,并自动配置每个编辑器。然后重新启动编辑器。

一次为所有编辑器安装

npx wordex-mcp init --global

为特定编辑器安装

npx wordex-mcp init --vscode      # VS Code only
npx wordex-mcp init --claude      # Claude Desktop only
npx wordex-mcp init --cursor      # Cursor only
npx wordex-mcp init --windsurf    # Windsurf only
npx wordex-mcp init --continue    # Continue.dev only

20个工具概览

📄 Word文档(.docx)

工具 说明
read_document 从任何路径读取任何.docx文件
create_document 使用markdown或纯文本创建新的.docx
edit_document 在.docx中添加、预置、替换或替换所有内容
merge_documents 将多个.docx文件合并为一个
fill_template 更换 {{variable}} .docx模板中的占位符
convert_to_markdown 导出.docx→ .md文件
document_stats 字数、阅读时间、Flesch可读性得分
search_in_document 使用上下文行在.docx中搜索

📊 Excel电子表格(.xlsx)

工具 说明
read_document 阅读任何.xlsx表格或所有表格
create_document 从行数据创建新的.xlsx
edit_document 追加行、更新单元格或添加工作表
list_sheets 在.xlsx文件中列出所有工作表

📑 PDF文件(.PDF)

工具 说明
read_pdf 使用元数据和页面范围支持提取文本
search_in_pdf 在带有上下文的PDF中搜索
extract_pdf_tables 使用空间分析检测和提取表
extract_pdf_images 将嵌入的JPEG图像提取到文件夹中
chunk_pdf 将大型PDF拆分为带标签的部分

📊 PowerPoint(.pptx)

工具 说明
read_pptx 提取所有幻灯片、项目符号和演讲者笔记

🔍 光学字符识别

工具 说明
ocr_document 使用Tesseract.js(完全本地WASM)对任何图像(PNG/JPG/TIFF/BMP/WebP)进行OCR

🗂️ 文件系统和Git

工具 说明
list_documents 在任何目录中查找.docx、.xlsx和.pdf文件
get_git_diff 获取当前git diff
get_git_status 查看已更改/暂存/未跟踪的文件
auto_document 将AI生成的git diff文档另存为.docx

斜杠命令

类型 / 在Copilot Chat中触发结构化提示:

命令 它的作用
/doc-read 阅读并总结文档
/doc-write 将内容写入新文档
/doc-edit 编辑现有文档
/doc-autodoc 从git diff生成文档→ .docx
/doc-list 列出目录中的文档
/doc-search 在文档中搜索
/doc-pdf 阅读带有元数据的PDF
/doc-pptx 阅读PowerPoint演示文稿
/doc-template 用变量填充.docx模板
/doc-merge 合并多个.docx文件
/doc-stats 获取字数和可读性统计数据

支持的路径格式

WordEX在Mac和Windows上智能解析路径:

格式 示例
家庭速记 ~/Documents/report.docx
环境变量 $PROJECT_DOCS/spec.docx
相对路径 ./docs/notes.docx
绝对路径(Mac) /Users/name/work/tracker.xlsx
绝对路径(Windows) C:\Users\name\Documents\report.docx

手动设定

如果 init 未检测到您的编辑器,请手动添加:

VS Code — .vscode/mcp.json

{
  "servers": {
    "wordex": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "wordex-mcp"]
    }
  }
}

克劳德桌面/光标/风帆 --各自的配置文件:

{
  "mcpServers": {
    "wordex": {
      "command": "npx",
      "args": ["-y", "wordex-mcp"]
    }
  }
}

团队入职培训

每个团队成员在项目目录中运行一个命令:

npx wordex-mcp init

或承诺 .vscode/mcp.json 到您的仓库——团队中的每个人在打开项目时都会自动获得WordEX。

没有账户。没有API密钥。没有什么可以分享或轮换的。


从源头构建

git clone https://github.com/Sahith59/WordEX-MCP.git
cd WordEX-MCP
npm install
npm run build
node dist/cli.js init

隐私和安全

  • 无网络呼叫 --WordEX是一个纯本地stdio进程。零HTTP请求。
  • 无遥测 --没有任何跟踪或报告。
  • 没有API密钥 --没有任何类型的帐户或凭据。
  • 离线功能 --第一次后完全离线工作 npx 下载。
  • 您的数据保留在您的计算机上 --总是。

需求

  • Node.js 18+
  • 任何兼容MCP的编辑器(VS Code+Copilot、Claude Desktop、Cursor、Windsurf或Continue.dev)

许可证

MIT© 萨希特·雷迪·图马拉