OfficeCliMCP

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

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:

{
  "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

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

📄 License

MIT