FusionBrain MCP Server

FusionBrain MCP Server is an MCP server application based on Java + Spring Boot and FusionBrain SDK Starter.
The server provides tools for generating images by using FusionBrain API.

Features

• Uses FusionBrain SDK Starter configurable via application.yml, environment variables, or JVM options.
• Supports three main MCP tools:
  • startGenerateImage — starts image generation and returns task id
  • checkStatus — checks the status of started task by id
  • generateImageSync — starts image generation and blocks until image is ready

Configuration

SDK configuration

FusionBrain MCP Server uses default SDK settings, but they can be overridden. Some properties like api-key and secret-key are obligatory and must be defined.

| Property | Description | Default | |--------------------------|--------------------------------|-------------------------------| | fusionbrain.api-key | API key for FusionBrain access | — (required) | | fusionbrain.api-secret | Secret key for FusionBrain access | — (required) | | fusionbrain.base-url | FusionBrain server URL | https://api-key.fusionbrain.ai |

The full list of sdk properties can be found here.

MCP configuration

This server is based on Spring AI MCP Server Boot Starter. Properties of Spring AI can be overridden if needed.

This MCP server can be run with stdio transport and SSE (default option).

stdio transport can be set by activating Spring profile stdio:

java -Dspring.profiles.active=stdio ... -jar fusionbrain-mcp-server.jar

Note that in stdio profile logging to console is disabled, and you have to activate file logs by defining:

logging.file.path=/app/logs                 # directory where rolling log files are collected
logging.file.name=/app/logs/mcp-server.log  # path to a log file

Ways to set parameters:

1. Via JVM options:

   java -jar \
    -Dfusionbrain.api-key=<your-api-key> \
    -Dfusionbrain.secret-key=<your-secret-key> \
    fusionbrain-mcp-server.jar
   

2. Via environment variables:

   export FUSIONBRAIN_APIKEY=<your-api-key>
   export FUSIONBRAIN_SECRETKEY=<your-secret-key>
   java -jar fusionbrain-mcp-server.jar
   

Build

Build .jar from source

cd <path/to/fusionbrain-mcp-server>
make build

The built file will be located at:

target/fusionbrain-mcp-server-<version>.jar

Build Docker image

cd <path/to/fusionbrain-mcp-server>
make docker

The built image will be named:

fusionbrain-mcp-server:latest

Run

Via Java (JAR)

java -jar \
  -Dfusionbrain.api-key=your-api-key \
  -Dfusionbrain.secret-key=your-secret-key \
  target/FusionBrain-mcp-server.jar

Via Docker

docker run --rm \
  -e FUSIONBRAIN_APIKEY=your-api-key \
  -e FUSIONBRAIN_SECRETKEY=your-api-key \
  -e JAVA_OPTS=<your jvm options> \
  -p 8080:8080 \
  fusionbrain-mcp-server:latest

Tools

startGenerateImage

Start image generation. Accepts the following request format:

{
  "request": {
    "style": "",
    "width": 1024,
    "height": 1024,
    "prompt": "your prompt"
  }
}

By default, width and height values are 1024. This tool accepts these generation params and calls image generation API. As generation takes some time to be finished, this tool does not wait for it and returns taskId, by which the status of the generation can be requested.

R

... View full README on GitHub