ImaginePro

ImaginePro MCP Server lets you connect ImaginePro AI image and video generation capabilities to your MCP-compatible assistants, enabling fast creative content generation from natural language and real-time task progress without leaving your tooling.

How to use

Connect the ImaginePro MCP Server to your MCP client (such as Claude Desktop or Claude Code). You will configure a local or remote MCP server entry and then issue generation requests through your client. The server supports a suite of tools for text-to-image, multi-modal generation, video creation, upscaling, variants, inpainting, and status tracking. Start a task with the appropriate tool, and monitor progress as the server handles image or video generation, progress updates, and final content URLs.

Typical usage patterns include: creating a new image from a text prompt, generating a variant of an existing image, upscaling a result, or composing a short video from start and end frames. You can also combine text prompts with existing images for multi-modal results, or edit a region of an image using a mask. Use the status fetch tool to monitor long-running tasks and retrieve final content URLs when ready.

How to install

Prerequisites you need before installing the server:

• Node.js 18 or newer

• An ImaginePro API key

• A MCP client you plan to use (such as Claude Desktop or Claude Code)

Choose an installation method that fits your workflow. The quickest way to get started uses a local runtime with npx, followed by configuring your MCP client to point at the server. The steps below show two common options: Quick Install with npx and Global Installation.

Option 1: Quick Install with npx (Recommended)

{
  "mcpServers": {
    "imaginepro": {
      "command": "npx",
      "args": ["-y", "imaginepro-mcp-server"],
      "env": {
        "IMAGINEPRO_API_KEY": "sk-your-api-key-here"
      }
    }
  }
}

Claude Desktop configuration example

Add the MCP server entry to the Claude Desktop configuration so requests are routed to the ImaginePro MCP Server.

{
  "mcpServers": {
    "imaginepro": {
      "command": "npx",
      "args": ["-y", "imaginepro-mcp-server"],
      "env": {
        "IMAGINEPRO_API_KEY": "sk-your-api-key-here"
      }
    }
  }
}

Claude Code quick add (CLI)

Set your API key and add the MCP server via Claude Code using the provided command pattern.

# Set your API key first
export IMAGINEPRO_API_KEY="sk-your-api-key-here"

# Add the server with the API key
claude mcp add-json imaginepro '{"command":"npx","args":["-y","imaginepro-mcp-server"],"env":{"IMAGINEPRO_API_KEY":"'$IMAGINEPRO_API_KEY'"}}' -s local

# Make your API key permanent (persist across sessions)
echo 'export IMAGINEPRO_API_KEY="sk-your-api-key-here"' >> ~/.zshrc
source ~/.zshrc

Option 2: Global Installation

Install the MCP server globally and configure a local entry to run it.

npm install -g imaginepro-mcp-server

{
  "mcpServers": {
    "imaginepro": {
      "command": "imaginepro-mcp-server",
      "env": {
        "IMAGINEPRO_API_KEY": "sk-your-api-key-here"
      }
    }
  }
}

Option 3: Local Development

For development or customization, clone the project, install dependencies, build, and run from the built distribution.

git clone https://github.com/imaginpro/imaginepro-mcp-server.git
cd imaginepro-mcp-server
npm install
npm run build

{
  "mcpServers": {
    "imaginepro": {
      "command": "node",
      "args": ["/absolute/path/to/imaginepro-mcp-server/dist/index.js"],
      "env": {
        "IMAGINEPRO_API_KEY": "sk-your-api-key-here"
      }
    }
  }
}

Environment variables and advanced configuration

Use environment variables to customize behavior. The key variable is IMAGINEPRO_API_KEY. Optional variables include IMAGINEPRO_BASE_URL for a custom API endpoint and IMAGINEPRO_TIMEOUT to adjust request timeouts.

{
  "mcpServers": {
    "imaginepro": {
      "command": "npx",
      "args": ["-y", "imaginepro-mcp-server"],
      "env": {
        "IMAGINEPRO_API_KEY": "sk-your-api-key-here",
        "IMAGINEPRO_BASE_URL": "https://api.imaginepro.ai",
        "IMAGINEPRO_TIMEOUT": "600000"
      }
    }
  }
}

Troubleshooting

Common issues include missing API keys, invalid keys, network problems, or incorrect command configuration. Ensure the API key is set in the MCP config or environment, verify Node.js version, and confirm the MCP client can reach the server endpoint. If a server command cannot be found, use the explicit path or switch to npx as shown in the quick-install examples.

Tools and capabilities

The server provides a comprehensive set of generation tools that cover image creation, multi-modal inputs, video generation, upscaling, variants, inpainting, and status tracking. Each tool returns a structured response with a content URL when ready and supports real-time progress reporting.

Notes

Chaining tools enables complete creative workflows, such as generating an image, creating variants, upscaling the best result, and applying inpainting to add final details. Real-time progress updates help you monitor long-running tasks.

Available tools

generate-image

Create AI images from text prompts with real-time progress and final image URL.

gemini-imagine

Generate images using multi-modal inputs by combining text prompts with existing images.

generate-video

Produce video sequences transitioning between two frames with a final video URL.

upscale-image

Increase image resolution and quality through AI upscaling.

create-variant

Generate alternative versions of an existing image.

reroll-image

Regenerate an image using the same prompt for a different result.

inpaint-image

Edit specific regions of an image using a mask and a prompt.

fetch-status

Check real-time status and progress of any generation task.