Scenario Ai MCP Server

🚀 用於與Scenario.com API交互的MCP服務器項目

本項目精心打造了一個MCP（模型上下文協議）服務器，專門用於和Scenario.com API進行交互。此服務器具備強大的圖像生成與背景去除功能，同時還配備了詳盡的文檔，能全方位指導用戶完成服務器的設置、使用以及故障排除等操作。

🚀 快速開始

本項目的MCP服務器可助力用戶便捷地與Scenario.com API交互，實現圖像生成和背景去除等功能。下面為您詳細介紹項目的設置與運行步驟。

📦 安裝指南

系統要求

• 操作系統：支持Windows、Linux 或 macOS。
• Python版本：需為3.6或更高版本。
• 安裝依賴項：

pip install mcp python-dotenv requests

配置文件

在項目的根目錄下創建一個.env文件，並添加以下內容：

SCENARIO_API_KEY=your_api_key_here
SCENARIO_API_SECRET=your_api_secret_here
SCENARIO_MODEL_ID=your_model_id_here

啟動服務器

使用以下命令啟動MCP服務器：

python src/server.py

💻 使用示例

基礎用法

在examples/client_example.py中提供了詳細的使用示例：

from mcp.client import MCPClient

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

腳本使用

• 啟動服務器：運行scripts/start_server.sh（Linux/macOS）或start_server.bat（Windows）。
• 運行示例：執行scripts/run_client_example.sh（Linux/macOS）或run_client_example.bat（Windows）。
• 執行測試：使用scripts/run_tests.sh（Linux/macOS）或run_tests.bat（Windows）。

📚 詳細文檔

倉庫結構

項目的代碼倉庫包含以下主要文件和目錄：

• src/：項目的核心源代碼。
• examples/：示例腳本，展示如何使用MCP服務器。
• scripts/：實用腳本，用於啟動服務器、運行示例和執行測試。
• tests/：測試用例，驗證MCP服務器的功能。
• LICENSE：項目的許可證文件。
• README.md：項目說明文檔。

提供的工具和資源

工具

1. 圖像生成：通過給定提示詞生成高質量圖像。
2. 背景去除：處理指定資產ID的圖像，去除其背景。

資源

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

測試和文檔

運行測試以驗證服務器功能並查看詳細文檔：

python -m pytest tests/

故障排除

服務器啟動問題

• 確保安裝了所有依賴項。
• 檢查.env文件是否正確配置。
• 確認虛擬環境已激活。

API 錯誤

• 驗證API憑證的有效性。
• 確保使用的模型ID有效。
• 查看Scenario.com官方文檔瞭解服務狀態和更新信息。

📄 許可證

該項目遵循MIT許可證，詳細信息請查閱LICENSE文件。