Scenario AI

🚀 このプロジェクトは何をするものですか？

このプロジェクトは、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

3. 依存関係のインストール：仮想環境で必要なPythonパッケージをインストールします。

pip install -r src/requirements.txt

4. 環境変数の設定：config.envファイルを作成し、以下の内容を追加します。

SCENARIO_API_KEY=your_api_key
SCENARIO_API_SECRET=your_api_secret
SCENARIO_MODEL_ID=model_id

5. MCP SDKとpython-dotenvのインストール：

pip install mcp python-dotenv

サーバーの起動

MCPサーバーの起動

以下のコマンドを使用してサーバーを起動します。

# 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

✨ 主な機能

利用可能なツール

画像生成

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

背景削除

mcp remove-background --asset-id your_asset_id

リソース

• サーバーの状態情報を取得：status://info
• ジョブの状態を確認：job://{job_id}
• アセット情報を表示：asset://{asset_id}

💻 使用例

基本的な使用法

examples/client_example.pyには、MCPサーバーを呼び出すサンプルコードがあります。以下のコマンドでスクリプトを実行します。

# MacOS/Linux
python examples/client_example.py

# Windows
python examples\client_example.py

スクリプトの使用

• 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サーバーをスムーズに設定して実行し、画像生成と背景削除の機能を利用できます。