Bumi Digital MCP Server

Model Context Protocol (MCP) server for Bumi Digital — generate AI images, videos, audio, and upscale media directly from MCP-compatible AI assistants (Claude Desktop, Cursor, Trae, and others).

This server is a thin wrapper over the Bumi Digital public REST API v1. All business logic (credits, refunds, storage, webhooks) is enforced by the API — nothing is duplicated here.

Features

• 11 tools covering the full Bumi Digital API surface

• Dual transport: stdio (local) and Streamable HTTP (remote/hosted)

• Per-request auth in HTTP mode — one deployment serves many users, each with their own API key

• Stateless HTTP — no session storage required, scales horizontally

• Docker-ready — Dockerfile included for Coolify/VPS deployment

Related MCP server: Jimeng MCP Server

Tools

Generation endpoints may return status: "completed" immediately or "processing" for async results — poll with get_generation_status until completed/failed. Credits are deducted upfront and refunded automatically on failure.

Getting an API Key

1. Sign in to bumi.digital

2. Go to Settings → API Keys

3. Create a key — it starts with bd_

Usage

Option A: stdio (local MCP client)

Build from source:

npm install
npm run build

Add to your MCP client config (Claude Desktop, Cursor, Trae, etc.):

{
  "mcpServers": {
    "bumi-digital": {
      "command": "node",
      "args": ["/path/to/bumi-digital-mcp/dist/index.js"],
      "env": {
        "BUMI_API_KEY": "bd_your_api_key_here"
      }
    }
  }
}

Option B: Remote MCP (hosted via HTTP)

Run the server:

node dist/index.js --http
# or: MCP_TRANSPORT=http node dist/index.js

Client config — no installation needed, just the URL:

{
  "mcpServers": {
    "bumi-digital": {
      "url": "https://mcp.bumi.digital/mcp",
      "headers": {
        "Authorization": "Bearer bd_your_api_key_here"
      }
    }
  }
}

Endpoints:

• POST /mcp — MCP protocol (Streamable HTTP)

• GET /health — health check, returns { "ok": true }

Configuration

Self-Hosting (Optional)

If you operate your own Bumi Digital instance, this server can be self-hosted in HTTP mode. A Dockerfile is included — it builds the project and serves /mcp on PORT (default 3100). Point your MCP clients to https://your-domain/mcp with Authorization: Bearer bd_....

Development

npm install
npm run build        # compile TypeScript
npm run start        # stdio mode
npm run start:http   # HTTP mode on PORT (default 3100)

Requires Node.js >= 18.

License

MIT