Scenario AI MCP Server

Name: Scenario AI MCP Server
Author: pasie15

@pasie15

Repository

About Scenario AI MCP Server

A Model Context Protocol (MCP) server for the Scenario AI API

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "scenario-ai-mcp-server": {
      "command": "python",
      "args": [
        "src/server.py"
      ]
    }
  }
}

Tools

`prompt` (required): The text prompt describing the image to generate

`asset_id` (required): The asset ID of the image to process

Overview

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.

Comments

More Other MCP servers

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K