Scenario Ai MCP Server

🚀 プロジェクト名

このプロジェクトは、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ファイルを参照してください。