mcp-officecli-bridge

Streamable HTTP bridge for OfficeCLI official MCP (officecli mcp stdio) — so it can be used with Gemini Spark Custom App and hosted on Coolify (Tencent Cloud).

Does not re-implement OfficeCLI tools. All tools (create, view, get, query, add, set, remove, move, swap, batch, dump, merge, validate, …) are automatically exposed from upstream.

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

Deploy on Coolify (2 minutes)

1. Coolify → + New Service → Application → select repo mcp_office_cli

2. Build Pack: Dockerfile — Port: 3000

3. (Optional) Set domain: mcp.yourdomain.com

4. Deploy → check https://mcp.yourdomain.com/health → {"status":"ok"}

5. Gemini Spark → Custom App → MCP URL = https://mcp.yourdomain.com/mcp

Related MCP server: AgentCore MCP Server

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