Scenario Ai MCP Server

This project is an MCP server based on the Scenario.com platform, providing text - to - image generation and image background removal functions, including a complete development environment configuration, sample code, and test scripts.

Image and video processing Marketing #Image generation #Background removal #AI service #API integration .Python

rating : 2 points

downloads : 16

update time : 2025-04-28

What is Scenario.com MCP Server?

This is an AI service interface based on the Scenario.com platform, providing two core functions: 1) Generate high - quality images based on text descriptions. 2) Automatically remove the background of pictures. The service adopts the Model Context Protocol (MCP) standard, which is convenient for integration with other systems.

How to use Scenario.com MCP Server?

Just follow three simple steps: 1) Install the necessary software environment. 2) Configure the API key. 3) Send text instructions or pictures to get the processing results. There is no need to write complex code, and you can quickly get started through sample scripts.

Applicable scenarios

It is particularly suitable for scenarios that require rapid visualization of creativity, such as e - commerce product image generation, social media content creation, game character design, and advertising material production. Designers, marketers, and content creators can all benefit.

Main features

Text - to - imageInput text descriptions to generate high - quality images, supporting adjustment of negative prompt words and the number of generations.

Intelligent background removalAutomatically identify the main body of the picture and remove the background, retaining the transparent channel.

Task trackingQuery the status and results of image generation or processing tasks in real - time.

Advantages and limitations

Advantages

Create high - quality visual content without professional design skills.

Fast processing speed, usually completing complex tasks within a few minutes.

Provide complete APIs and sample code for easy integration.

Limitations

An effective Scenario.com API key is required.

Complex prompt words may need to be adjusted multiple times to obtain ideal results.

Free accounts have a limit on the number of calls.

How to use

Environment preparation

Install Python 3.8+ and create a virtual environment.

Install dependencies

Install the necessary software packages.

Configure the key

Create a.env file in the project root directory and fill in your API key.

Start the service

Run the server to start receiving requests.

Usage examples

E - commerce product image generationCreate display images for new products without actual shooting.

Social media material productionQuickly generate social media pictures with festival themes.

ID photo background processingConvert casually taken photos into professional ID photos.

Frequently Asked Questions

How to get an API key?

How long does it take to generate an image?

What picture formats are supported?

What should I do if I encounter the 'Invalid API Key' error?

Related resources

Scenario.com official documentation

Complete API reference and development guide.

GitHub repository

Project source code and issue tracking.

Sample project set

Practical cases for various application scenarios.

🚀 MCP Server for Scenario.com API

This project offers an MCP (Model Context Protocol) server for interacting with the Scenario.com API. It supports image generation and background removal features, and provides detailed documentation to guide users through setup, usage, and troubleshooting.

🚀 Quick Start

Repository Structure

The project's code repository contains the following main files and directories:

src/: The core source code of the project.
examples/: Example scripts demonstrating how to use the MCP server.
scripts/: Utility scripts for starting the server, running examples, and executing tests.
tests/: Test cases to verify the functionality of the MCP server.
LICENSE: The project's license file.
README.md: The project documentation.

Project Setup

System Requirements

Operating System: Windows, Linux, or macOS
Python Version: 3.6 or higher
Install dependencies:

pip install mcp python-dotenv requests

Configuration File

Create a .env file in the project's root directory and add the following content:

SCENARIO_API_KEY=your_api_key_here
SCENARIO_API_SECRET=your_api_secret_here
SCENARIO_MODEL_ID=your_model_model_id_here

Server Operation

Start the Server

Use the following command to start the MCP server:

python src/server.py

Example Script

An example script is provided in the examples/ directory to demonstrate how to call the server's functions.

✨ Features

Tools

Image Generation: Generate high-quality images given a prompt.
Background Removal: Process an image with a specified asset ID to remove its background.

Resources

/status/info: Get server status information.
/job/{job_id}: Query the status of a specific job.
/asset/{asset_id}: Get information about a specific asset.

💻 Usage Examples

Basic Usage

A detailed usage example is provided in examples/client_example.py:

from mcp.client import MCPClient

client = MCPClient()
response = client.generate_image("a beautiful sunset over mountains")
print(response)

Script Usage

Start the server: Run scripts/start_server.sh (Linux/macOS) or start_server.bat (Windows).
Run examples: Execute scripts/run_client_example.sh (Linux/macOS) or run_client_example.bat (Windows).
Execute tests: Use scripts/run_tests.sh (Linux/macOS) or run_tests.bat (Windows).

📚 Documentation

Run tests to verify the server's functionality and view detailed documentation:

python -m pytest tests/

🔧 Technical Details

Server Startup Issues

Ensure all dependencies are installed.
Check if the .env file is correctly configured.
Confirm that the virtual environment is activated.

API Errors

Verify the validity of the API credentials.
Ensure the model ID being used is valid.
Refer to the official Scenario.com documentation for service status and update information.