Scenario AI

🚀 基於Scenario.com的MCP服務器項目

本項目是一個基於Scenario.com的MCP服務器，具備圖像生成和背景移除功能。用戶只需配置API密鑰和模型ID，就能在開發環境中輕鬆運行該服務器。

🚀 快速開始

環境準備

1. 安裝Python環境：確保系統已安裝Python 3.6或更高版本，推薦使用虛擬環境管理依賴項。
2. 創建並激活虛擬環境：

python -m venv .venv
source .venv/bin/activate  # MacOS/Linux
.\.venv\Scripts\activate  # Windows

安裝依賴

1. 安裝項目依賴項：在虛擬環境中安裝所需的Python包。

pip install -r src/requirements.txt

2. 安裝MCP SDK和python - dotenv：

pip install mcp python-dotenv

配置環境變量

創建並編輯config.env文件，添加以下內容：

SCENARIO_API_KEY=your_api_key
SCENARIO_API_SECRET=your_api_secret
SCENARIO_MODEL_ID=model_id

啟動服務器

# MacOS/Linux
mcp-server src/scenario_mcp_server.py --config ./.env

# Windows
set SCENARIO_API_KEY=your_api_key & set SCENARIO_API_SECRET=your_api_secret & set SCENARIO_MODEL_ID=model_id & mcp-server src\scenario_mcp_server.py --config .\.env

✨ 主要特性

• 圖像生成：通過指定提示詞，可生成符合要求的圖像。
• 背景移除：根據資產ID移除圖像背景。

📦 安裝指南

安裝Python環境

確保系統上已安裝Python 3.6或更高版本，建議使用虛擬環境管理依賴項。

創建並激活虛擬環境

python -m venv .venv
source .venv/bin/activate  # MacOS/Linux
.\.venv\Scripts\activate  # Windows

安裝依賴項

pip install -r src/requirements.txt

配置環境變量

創建並編輯config.env文件，添加API密鑰、API秘密和模型ID：

SCENARIO_API_KEY=your_api_key
SCENARIO_API_SECRET=your_api_secret
SCENARIO_MODEL_ID=model_id

安裝MCP SDK和python - dotenv

pip install mcp python-dotenv

💻 使用示例

基礎用法

生成圖像

mcp generate-image --prompt your_prompt_here [--negative-prompt your_negative_prompt] [--num-samples 5]

移除背景

mcp remove-background --asset-id your_asset_id

高級用法

在examples/client_example.py中，用戶可以找到如何調用MCP服務器的示例代碼。通過運行腳本：

# MacOS/Linux
python examples/client_example.py

# Windows
python examples\client_example.py

📚 詳細文檔

倉庫結構

資源

• 獲取服務器狀態信息：status://info
• 查詢作業狀態：job://{job_id}
• 查看資產信息：asset://{asset_id}

腳本使用

• start_server.bat/sh：啟動MCP服務器。
• run_client_example.bat/sh：運行示例客戶端。
• run_tests.bat/sh：執行測試套件。

測試與文檔查看

運行以下命令以執行測試並查看文檔：

python -m pytest tests/test_server.py -v

測試文件tests/test_server.py詳細記錄瞭如何使用Scenario.com的MCP服務器，包括：

1. 服務器配置說明。
2. 可用工具及其參數。
3. 資源訪問方式。
4. 使用Roo - Cline界面的完整工作流示例。

🔧 技術細節

故障排除

無法啟動服務器的問題

1. 確保已安裝MCP SDK和python - dotenv：

pip install mcp python-dotenv

2. 檢查虛擬環境中是否包含所有依賴項：

pip install -r src/requirements.txt

3. 驗證config.env文件配置正確。

API錯誤

1. 確認API密鑰和秘密正確無誤。
2. 驗證模型ID的有效性。
3. 查看Scenario.com官方文檔以獲取最新信息。

📄 許可證

本項目遵循MIT許可證。請參閱LICENSE文件瞭解詳細內容。

通過以上步驟，用戶可以順利配置並運行基於Scenario.com的MCP服務器，實現圖像生成和背景移除功能。