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文件。