README

mcp-officecli-bridge

Streamable HTTP bridge for OfficeCLI official MCP (officecli mcp stdio) — supaya bisa dipakai Gemini Spark Custom App dan di-host di Coolify (Tencent Cloud).

Tidak re-implement tools OfficeCLI. Semua tools (create, view, get, query, add, set, remove, move, swap, batch, dump, merge, validate, …) otomatis ke-expose dari upstream.

Gemini Spark --POST /mcp (Streamable HTTP)-->  Express (src/server.ts)  --stdio-->  officecli mcp

Deploy di Coolify (2 menit)

Coolify → + New Service → Application → pilih repo mcp_office_cli
Build Pack: Dockerfile — Port: 3000
(Opsional) Set domain: mcp.yourdomain.com
Deploy → cek https://mcp.yourdomain.com/health → {"status":"ok"}
Gemini Spark → Custom App → MCP URL = https://mcp.yourdomain.com/mcp

Local test

npm install
npm run build
# butuh officecli terinstall (winget/brew/npm) untuk test lokal, atau pakai Docker
npm start
# test
curl http://localhost:3000/health
curl -X POST http://localhost:3000/mcp -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}'

Inspector

npx @modelcontextprotocol/inspector
# URL: http://localhost:3000/mcp  (Streamable HTTP)

Env

Var	Default	Deskripsi
`PORT`	`3000`	Port HTTP
`OFFICECLI_BIN`	`officecli`	Path binary officecli
`REQUEST_TIMEOUT_MS`	`25000`	Timeout proxy ke upstream
`MCP_AUTH_TOKEN`	-	Jika diisi, butuh `Authorization: Bearer <token>` (todo: wiring)

mcp-officecli-bridge

README

mcp-officecli-bridge

Deploy di Coolify (2 menit)

Local test

Inspector

Env

Recommended Servers