# OfficeCLI MCP Server

MCP Server xử lý tài liệu Office cho C2A — 21 tools đọc, tạo, sửa, chuyển đổi, so sánh và phân tích tài liệu.

**Hỗ trợ:** DOCX, XLSX, PPTX, PDF, Markdown

## 🚀 Chạy nhanh

```bash
docker compose up -d
curl http://localhost:8100/health
```

Server chạy tại port **8100**, MCP endpoint tại `/mcp`.

## 🛠️ 21 Tools

### 📖 Đọc & Trích xuất (6)
| Tool | Mô tả |
|---|---|
| `read_document` | Đọc file → Markdown (DOCX, XLSX, PPTX, PDF, MD, TXT) |
| `read_sheet` | Đọc sheet Excel → bảng Markdown |
| `read_slides` | Đọc PowerPoint → Markdown |
| `extract_tables` | Trích xuất tất cả bảng từ tài liệu |
| `extract_images` | Trích xuất metadata ảnh từ Markdown |
| `extract_metadata` | Metadata file (size, modified, type) |

### ✏️ Chỉnh sửa (5)
| Tool | Mô tả |
|---|---|
| `edit_document` | Tìm & thay thế trong DOCX |
| `edit_sheet` | Cập nhật ô Excel |
| `insert_content` | Chèn nội dung vào DOCX |
| `delete_content` | Xóa nội dung khỏi DOCX |
| `replace_all` | Tìm & thay thế tất cả trong DOCX |

### 📝 Tạo mới (3)
| Tool | Mô tả |
|---|---|
| `create_document` | Tạo DOCX/PPTX/XLSX từ Markdown |
| `create_report` | Tạo báo cáo Word từ dữ liệu Excel |
| `create_slides` | Tạo PowerPoint từ outline Markdown |

### 🔄 Chuyển đổi (3)
| Tool | Mô tả |
|---|---|
| `convert_document` | Chuyển đổi format bằng Pandoc |
| `merge_documents` | Gộp nhiều tài liệu thành một |
| `split_document` | Tách tài liệu thành nhiều file |

### 🔍 So sánh & Phân tích (3)
| Tool | Mô tả |
|---|---|
| `diff_documents` | So sánh 2 tài liệu → báo cáo khác biệt |
| `analyze_data` | Phân tích Excel → thống kê, xu hướng, tương quan |
| `summarize_document` | Tóm tắt tài liệu dài |

### 🗂️ Quản lý file (1)
| Tool | Mô tả |
|---|---|
| `list_files` | Liệt kê file trong workspace |

## 🔌 Kết nối với C2A

Thêm vào C2A MCP client config:

```json
{
  "mcpServers": {
    "officecli": {
      "url": "http://officecli:8100/mcp"
    }
  }
}
```

## 📂 Workspace

File được lưu trong `/mnt/data/officecli/workspace/` (mount vào container tại `/app/data/workspace`).

## 🏗️ Build

```bash
docker compose build --no-cache
docker compose up -d
```

## 📄 License

MIT