🚀 用于与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：项目说明文档。
提供的工具和资源
工具
- 图像生成：通过给定提示词生成高质量图像。
- 背景去除：处理指定资产ID的图像，去除其背景。
资源
/status/info：获取服务器状态信息。/job/{job_id}：查询特定作业的状态。/asset/{asset_id}：获取特定资产的信息。
测试和文档
运行测试以验证服务器功能并查看详细文档：
python -m pytest tests/
故障排除
服务器启动问题
- 确保安装了所有依赖项。
- 检查
.env文件是否正确配置。 - 确认虚拟环境已激活。
API 错误
- 验证API凭证的有效性。
- 确保使用的模型ID有效。
- 查看Scenario.com官方文档了解服务状态和更新信息。
📄 许可证
该项目遵循MIT许可证，详细信息请查阅LICENSE文件。