word-to-pdf-mcp

Remote MCP server that converts .docx to PDF. Works with any MCP client — Claude (web & CLI), Cursor, Windsurf, or anything that speaks the Model Context Protocol.

Runs as a Docker container with LibreOffice as a persistent daemon (unoserver). First conversion triggers a warmup; subsequent conversions take ~0.3s.

cp .env.example .env
touch credentials.json
docker compose up -d --build
docker compose exec mcp-pdf python manage_keys.py add yourname

Requires an external Docker network (docker network create caddy_net) and a reverse proxy for TLS (see Reverse proxy).

docker compose exec mcp-pdf python manage_keys.py add <name>
docker compose exec mcp-pdf python manage_keys.py list
docker compose exec mcp-pdf python manage_keys.py revoke <client_id>

No restart needed — changes take effect immediately.

Add a remote MCP server in Claude's settings with your server URL:

https://your-domain.com/

Claude will handle OAuth automatically. When the authorize page opens, paste your API key (sk_... from manage_keys.py add).

Add to ~/.claude/claude_code_config.json:

{
  "mcpServers": {
    "pdf-tools": {
      "type": "sse",
      "url": "https://your-domain.com/sse",
      "headers": {
        "Authorization": "Bearer <your_sk_key>"
      }
    }
  }
}

Use the SSE transport config:

{
  "mcpServers": {
    "pdf-tools": {
      "type": "sse",
      "url": "https://your-domain.com/sse",
      "headers": {
        "Authorization": "Bearer <your_sk_key>"
      }
    }
  }
}

If your client supports Streamable HTTP, use the root URL (https://your-domain.com/) instead.

Input: base64-encoded .docx file

Output:

{
  "success": true,
  "download_ur