项目概述

该项目提供了一个用于与Scenario.com API交互的MCP（模型上下文协议）服务器。该服务器支持图像生成和背景去除功能，并提供了详细的文档指导用户完成设置、使用和故障排除。

仓库结构

项目的代码仓库包含以下主要文件和目录：

• src/：项目的核心源代码。
• examples/：示例脚本，展示如何使用MCP服务器。
• scripts/：实用脚本，用于启动服务器、运行示例和执行测试。
• tests/：测试用例，验证MCP服务器的功能。
• LICENSE：项目的许可证文件。
• README.md：项目说明文档。

项目设置

系统要求

• 操作系统：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/目录下提供了一个示例脚本，展示如何调用服务器功能。

提供的工具和资源

工具

1. 图像生成：通过给定提示词生成高质量图像。
2. 背景去除：处理指定资产ID的图像，去除其背景。

资源

• /status/info：获取服务器状态信息。
• /job/{job_id}：查询特定作业的状态。
• /asset/{asset_id}：获取特定资产的信息。

使用示例

在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）。

测试和文档

运行测试以验证服务器功能并查看详细文档：

python -m pytest tests/

故障排除

服务器启动问题

• 确保安装了所有依赖项。
• 检查.env文件是否正确配置。
• 确认虚拟环境已激活。

API 错误

• 验证API凭证的有效性。
• 确保使用的模型ID有效。
• 查看Scenario.com官方文档了解服务状态和更新信息。

许可证

该项目遵循MIT许可证，详细信息请查阅LICENSE文件。