Cinema4D MCP Server

Instructions

Create a snapshot of the current scene state.

Args:
    file_path: Optional path to save the snapshot
    include_assets: Whether to include external assets in the snapshot

Implementation Reference

• src/cinema4d_mcp/server.py:1172-1197 (handler)

  The handler function 'snapshot_scene' that orchestrates communication with Cinema 4D to trigger a scene snapshot.

  async def snapshot_scene(
      file_path: Optional[str] = None, include_assets: bool = False, ctx: Context = None
  ) -> str:
      """
      Create a snapshot of the current scene state.
  
      Args:
          file_path: Optional path to save the snapshot
          include_assets: Whether to include external assets in the snapshot
      """
      async with c4d_connection_context() as connection:
          if not connection.connected:
              return "❌ Not connected to Cinema 4D"
  
          # Prepare command
          command = {"command": "snapshot_scene"}
  
          if file_path:
              command["file_path"] = file_path
  
          command["include_assets"] = include_assets
  
          # Send command to Cinema 4D
          response = send_to_c4d(connection, command)
  
          return format_c4d_response(response, "snapshot_scene")

• src/cinema4d_mcp/server.py:1171-1171 (registration)

  Registration of the snapshot_scene tool using the @mcp.tool() decorator.

  @mcp.tool()