Skip to main content
Glama
kerjaanlucky

OfficeCLI MCP Serverless for Gemini Spark

by kerjaanlucky

OfficeCLI MCP Serverless for Gemini Spark

Stateless & Serverless Model Context Protocol (MCP) server yang membungkus OfficeCLI untuk membuat dan mengedit dokumen Microsoft Word (.docx) langsung melalui instruksi AI di Gemini Spark Custom App.


🚀 Fitur Utama

  • Stateless & Serverless Ready: Didesain khusus untuk runtime Vercel Functions (/tmp scratch space, auto-cleanup).

  • Batch Pipeline Execution: Menjalankan kumpulan perintah OfficeCLI secara berurutan dalam satu turn request.

  • Base64 Data URL Output: Menghasilkan file Word langsung dalam format Base64 Data URL tanpa perlu external storage (S3/Blob).

  • Auto Binary Provisioning: Otomatis mengunduh atau menyiapkan executable officecli Linux x86_64 di environment serverless.


🛠️ Tool MCP yang Tersedia

generate_office_document

Mengeksekusi batch perintah OfficeCLI untuk membuat atau mengubah dokumen .docx.

Parameter Input:

  • filename (string, required): Nama file output (contoh: Laporan_Proyek.docx).

  • commands (string[], required): Daftar perintah OfficeCLI yang dieksekusi berurutan.

    [
      "create output.docx",
      "add output.docx / --type paragraph --prop \"text=Laporan Evaluasi Kuartal 3\"",
      "add output.docx / --type table --prop rows=3 --prop cols=3"
    ]
  • initial_file_base64 (string, optional): Base64 string dokumen awal jika ingin melakukan edit pada template existing.


📦 Menghubungkan ke Gemini Spark Custom App

  1. Deploy ke Vercel:

    pnpm install
    vercel deploy --prod
  2. Salin URL hasil deploy Vercel Anda, misalnya:
    https://officecli-mcp.vercel.app/api/index

  3. Tambahkan ke Gemini Spark:

    • Buka pengaturan Gemini Spark Custom App / Custom Tools / MCP Servers.

    • Masukkan Server URL: https://officecli-mcp.vercel.app/api/index (Transport: SSE / HTTP Remote MCP).

    • Simpan dan mulai perintahkan Gemini:

      "Buatkan saya dokumen Word tentang laporan bisnis lengkap dengan tabel metrik!"


💻 Development & Testing Lokal

# Install dependencies
pnpm install

# Menjalankan unit tests
pnpm test

# Menjalankan MCP server di mode stdio
pnpm dev