Scenario Ai MCP Server

🚀 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

1. Image Generation: Generate high-quality images given a prompt.
2. 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.

📄 License

This project is licensed under the MIT License. For detailed information, please refer to the LICENSE file.