Scenario AI MCP Server

What is Scenario AI MCP Server?

The Scenario AI MCP Server is a Model Context Protocol server that integrates with the Scenario AI platform (https://app.scenario.com/). It enables developers to generate images from text prompts and remove backgrounds from images programmatically via MCP tools.

How to use Scenario AI MCP Server?

Clone the repository, install dependencies from src/requirements.txt, set up a .env file with your Scenario AI API credentials (SCENARIO_API_KEY, SCENARIO_API_SECRET, and optionally SCENARIO_MODEL_ID), and run python src/server.py or use the provided start scripts in the scripts/ folder. The server exposes MCP tools (generate_image, remove_background) and resources (status://info, job://{job_id}, asset://{asset_id}) that can be used with a compatible client like Roo-Cline.

Key features of Scenario AI MCP Server

• Text-to-image generation using the Scenario AI API
• Background removal from images given an asset ID
• MCP resources for server status, job, and asset details
• Example clients and test suite included
• Scripts for easy startup on Windows and Linux/macOS

Use cases of Scenario AI MCP Server

• Generating game assets or concept art from text prompts
• Automatically removing backgrounds from product images
• Integrating AI image generation into creative workflows via MCP
• Building applications that require on-demand image creation and editing

FAQ from Scenario AI MCP Server

What API credentials are required?

You must provide SCENARIO_API_KEY and SCENARIO_API_SECRET in a .env file. An optional SCENARIO_MODEL_ID can be set as the default model for image generation.

Which Python dependencies are needed?

All dependencies are listed in src/requirements.txt and can be installed with pip install -r src/requirements.txt. Additionally, the MCP SDK must be installed (pip install mcp).

Where are generated images stored?

Images are stored on the Scenario AI platform. The server provides asset IDs and job IDs to retrieve them via the API.

What MCP tools does the server expose?

The server exposes generate_image (with parameters prompt, model_id, negative_prompt, num_samples) and remove_background (requires asset_id).

Can I run the server without setting up a model ID?

Yes, model_id is optional for generate_image; if omitted, it defaults to the value in the environment variable SCENARIO_MODEL_ID. If that is also unset, the API may require a valid model ID.