MCP Server Shotgrid

🚀 自動化 Shotgun REST API の MCP サーバー

このプロジェクトは、FastMCP を使用して実装された MCP（モデルコンテキストプロトコル）サーバーを提供します。これにより、大規模言語モデル (LLM) エージェントが Autodesk Shotgun の REST API を介してプログラム的にやり取りできるようになります。サーバーは、プロジェクト、アセット、タスクなどの Shotgun エンティティを照会および管理するための一連のツールを公開しています。HTTP と transport="stdio" モードをサポートし、LLM ベースのワークフローとの統合を容易にします。

✨ 主な機能

• OAuth2 認証を使用して Autodesk Shotgun に接続します。
• Shotgun REST API 操作を MCP ツールとして FastMCP を介して公開します。
• プロジェクト、アセット、タスクを照会します。
• エンティティの詳細情報を取得します。
• LLM ベースのワークフローとの統合を目的として設計されています。
• モジュール化されたコードベース：main.py は MCP サーバーとツール定義を提供し、shotgrid_rest.py は Shotgun REST API ラッパーを実装します。
• test_main.py を含み、自動化テストが可能です。

📦 インストール

• Python 3.11
• httpx
• httpx-auth
• mcp.server.fastmcp

💻 使用例

基本的な使用法

1. Shotgun の認証情報を設定する：

   • Shotgun のホスト URL、クライアント ID、クライアントシークレットを取得します。

2. サーバーを起動する（プレースホルダーを実際の値に置き換えてください）：

   uv run --directory {REPO_DIR} main.py -host https://your-shotgrid-url -ci your_client_id -cs your_client_secret
   

   すべての3つのパラメーターは必須です。短い形式 (-host, -ci, -cs) と長い形式 (--host, --client-id, --client-secret) の両方がサポートされています。 サーバーは FastMCP を使用し、transport="stdio" モードでのみ通信します。

3. LLM エージェントと統合する：

   • サーバーは MCP を介して LLM に呼び出し可能なツールを提供します。

高度な使用法

すべてのツールは非同期で、FastMCP を介して公開されています。

利用可能なツール：
括弧内のパラメーターは必須です。

• get_all_projects()
• get_all_users()
• get_all_projects_name_contains(name: str)
• get_all_projects_code_contains(code: str)
• get_all_sequences_in_project(project_name: str)
• get_all_shots_in_project(project_name: str)
• get_all_shots_code_contains(shot_code: str)
• get_all_assets_in_project(project_name: str)
• get_all_assets_code_contains(code: str)
• get_all_tasks_in_project(project_id: int)
• get_all_tasks_assigned_to_user(user_id: int)
• get_all_tasks_assigned_to_user_in_project_name(user_id: int, project_name: str)
• get_all_tasks_with_shot(shot_id: int)
• get_all_tasks_with_asset(asset_id: int)
• get_project_by_name(name: str)
• get_project_by_code(code: str)（新規）
• get_all_projects()
• get_project_details(project_id: int)
• get_project_assets(project_id: int, asset_type: str)（例：Characters, Props, Sets）
• get_asset_versions(asset_id: int)
• get_version_thumbnail(version_id: int)（サムネイルの URL を返します）

📚 ドキュメント

⚠️ 重要提示

• すべての依存関係がインストールされていることを確認してください。
• サーバーを起動する前に、正しい Shotgun の認証情報を設定してください。
• ツールをテストする際は、実際のデータに影響を与えないように、サンプルプロジェクトとアセットを使用してください。

📄 ライセンス

MIT ライセンス