# MCP Word文档处理工具 🤖

专为AI设计的Word文档处理MCP（Model Context Protocol）工具服务器，为AI助手提供强大的Word文档操作能力。支持大数据量表格处理和复杂文档格式化。

## ✨ 核心特性

- **🚀 高性能处理** - 支持大数据量表格（50+行×15+列）
- **🎨 富文本格式** - 多级标题、字体样式、颜色设置
- **📊 智能表格** - 自动格式化、专业布局
- **🔄 批量操作** - 文本替换、格式转换
- **🌏 中文友好** - 完美支持中文字符和段落

## 🎯 主要功能

### 📄 文档创建与管理
- **创建文档** - 支持多段落、换行符处理
- **读取文档** - 多种格式输出（Text/HTML/Markdown）
- **文本替换** - 精确查找替换功能

### 🎨 高级格式化
- **格式化文档** - 字体、大小、颜色、样式设置
- **多级标题** - 自动层级管理和编号
- **段落控制** - 对齐方式、行间距设置

### 📊 表格处理专家
- **大数据表格** - 支持50+行×15+列复杂表格
- **自动格式化** - 表头加粗、边框样式、列宽调整
- **数据类型支持** - 文本、数字、百分比、评级

## 🛠 MCP工具列表

### 1. create_docx
创建新的Word文档
```json
{
  "fileName": "示例文档",
  "title": "文档标题", 
  "content": "支持多段落内容\n\n第二段内容"
}
```

### 2. read_docx
读取Word文档内容
```json
{
  "filePath": "output/文档名.docx",
  "format": "text" // text|html|markdown
}
```

### 3. replace_text_in_docx
文档文本替换
```json
{
  "filePath": "output/原文档.docx",
  "searchText": "旧文本",
  "replaceText": "新文本", 
  "outputFileName": "更新后文档"
}
```

### 4. create_formatted_docx
创建格式化文档
```json
{
  "fileName": "格式化文档",
  "title": "报告标题",
  "contentArray": [
    {"text": "一级标题", "bold": true, "fontSize": 18, "color": "blue"},
    {"text": "正文内容", "fontSize": 12}
  ]
}
```

### 5. create_table_in_docx
创建表格文档（支持大数据量）
```json
{
  "fileName": "数据表格",
  "title": "统计报告",
  "tableData": {
    "headers": ["项目", "数值", "状态"],
    "rows": [
      ["项目A", "100", "完成"],
      ["项目B", "85", "进行中"]
    ]
  }
}
```

## 🚀 快速开始

### 环境要求
- Node.js 18.0+
- npm 或 yarn

### 安装和启动
```bash
# 安装依赖
npm install

# 启动服务器
cd src && node server.js
```

### 服务端点
- **MCP协议**: `http://localhost:3500/mcp`
- **管理界面**: `http://localhost:3500`
- **端口**: 3500

## 🎮 AI专用界面

访问 `http://localhost:3500` 查看AI专用功能展示界面：

- **功能文档** - 完整的API参数说明
- **使用示例** - JSON格式的调用样例
- **服务状态** - 实时监控MCP服务器状态
- **技术规格** - 支持的格式和特性列表

## 💪 大数据处理能力

### 已验证的处理规模
- ✅ **员工绩效表**: 25行×15列（9.4KB）
- ✅ **销售业绩表**: 50行×15列（11KB）
- ✅ **AI技术报告**: 5000字长文档（11KB）
- ✅ **格式化文档**: 多级标题+富文本（11KB）

### 性能表现
- **处理速度**: 59,761字符/秒
- **支持格式**: .docx、文本、HTML、Markdown
- **中文支持**: 完美支持中文字符和段落
- **内存效率**: 优化的流式处理

## 🔧 Cursor IDE集成

在Cursor设置中添加MCP配置：

```json
{
  "mcp.servers": {
    "word-tools": {
      "command": "node",
      "args": ["/path/to/MCP工具/src/server.js"],
      "env": {}
    }
  }
}
```

### AI使用示例

在Cursor中直接对AI说：

```
请创建一个员工绩效表格，包含25个员工的详细数据，包含姓名、部门、绩效评分等15个字段。
```

```
帮我读取刚才创建的表格文档，并总结一下员工的绩效分布情况。
```

```
创建一个5000字的AI技术发展报告，包含多级标题和格式化内容。
```

## 📂 项目结构

```
MCP工具/
├── src/
│   ├── server.js          # MCP服务器主文件
│   └── docxHandler.js     # Word文档处理核心
├── public/
│   └── index.html         # AI专用展示界面
├── documents/
│   ├── output/            # 生成的文档目录
│   └── templates/         # 文档模板
├── config/                # 配置文件
├── scripts/               # 工具脚本
├── test/                  # 测试文件
├── package.json
└── readme.md
```

## 📊 成功案例

### 1. 企业数据报表
- **25行员工绩效数据** - 完整的HR管理表格
- **50行销售业绩统计** - 全国销售数据分析
- **多维度数据展示** - 支持15+列复杂数据结构

### 2. 学术文档
- **5000字AI研究报告** - 完整的学术论文格式
- **多级标题结构** - 自动编号和层级管理
- **参考文献管理** - 标准学术引用格式

### 3. 格式化处理
- **段落分隔修复** - 解决长文档格式问题
- **中文支持优化** - 完美处理中文字符
- **样式自动应用** - 智能格式化和美化

## 🛡️ 技术特性

- **MCP协议兼容** - 标准Model Context Protocol
- **RESTful API** - 支持JSON数据交换
- **流式处理** - 高效的内存使用
- **错误恢复** - 智能错误处理和重试
- **并发安全** - 支持多客户端同时访问

## 📋 技术栈

- **运行时**: Node.js 18.0+
- **框架**: Express.js
- **协议**: @modelcontextprotocol/sdk
- **文档处理**: docx、mammoth
- **实用工具**: uuid、cors、fs

## 🔄 更新日志

### v1.2.0 (2024-05-30)
- ✅ 支持大数据量表格处理（50+行）
- ✅ 优化中文字符和段落处理
- ✅ 修复长文档格式分隔问题
- ✅ 新增AI专用展示界面
- ✅ 清理冗余文件和优化性能

### v1.1.0 
- ✅ 格式化文档功能
- ✅ 表格处理能力
- ✅ MCP协议集成

### v1.0.0
- ✅ 基础文档创建和读取
- ✅ 文本替换功能

## 🤝 贡献指南

欢迎提交Issue和Pull Request：

1. Fork本项目
2. 创建功能分支
3. 提交更改
4. 发起Pull Request

## 📜 许可证

MIT License - 可自由使用和修改