mcp ready with good docstrings explanation

app.py

@@ -112,7 +112,32 @@ def make_stereopair(left_img, right_img, color_method):
     return np.array(pair)
 
 def process_images(left_img, right_img, method, color_method):
-    """Process images based on the selected method"""
+
+    """Generate a 3D visualization from left and right stereo images.
+
+    This function processes a pair of stereo images (left and right views) and 
+    generates a 3D image using the specified visualization method:
+    
+    - "anaglyph": Combines the two images using a red-cyan color encoding, suitable 
+      for viewing with 3D glasses.
+    - "parallel": Places the images side by side for stereoscopic viewing with the 
+      parallel-eye method.
+    - "crossed": Similar to parallel, but with the left and right images swapped, 
+      suitable for cross-eyed viewing.
+
+    You can also specify the color processing style (e.g., "optimized", "mono", "true", etc.)
+    for finer control over color blending or grayscale conversion.
+
+    Args:
+        left_img (numpy.ndarray): The left-eye image as a NumPy array.
+        right_img (numpy.ndarray): The right-eye image as a NumPy array.
+        method (str): The 3D generation method, one of: "anaglyph", "parallel", or "crossed".
+        color_method (str): The color matrix to use for processing. Options include: "optimized", "true", "mono", "color", "halfcolor", "dubois", "dubois_optimized".
+
+    Returns:
+        numpy.ndarray: The resulting 3D image, ready to be displayed or saved.
+    """
+
     if method == "anaglyph":
         return make_anaglyph(left_img, right_img, color_method)
     elif method == "parallel":
@@ -134,31 +159,26 @@ with gr.Blocks(css=css) as app:
         gr.Markdown("Upload left and right images to create 3D images using different methods.")
         
         with gr.Row():
-            with gr.Column():
-                 
-                with gr.Row():
-                    with gr.Column():
-                        left_input = gr.Image(label="Left Image")
-                    with gr.Column():
-                        right_input = gr.Image(label="Right Image")
-            
+            left_input = gr.Image(label="Left Image")
+            right_input = gr.Image(label="Right Image")
+        
+        with gr.Row():
+            with gr.Column(): 
                 method = gr.Radio(
-                    ["anaglyph", "parallel", "crossed"], 
-                    label="Method", 
-                    value="anaglyph",
-                    info="Select the 3D image creation method"
+                            ["anaglyph", "parallel", "crossed"], 
+                            label="Method", 
+                            value="anaglyph",
+                            info="Select the 3D image creation method"
                 )
                     
                 color_method = gr.Radio(
-                    ["optimized", "true", "mono", "color", "halfcolor", "dubois", "dubois_optimized"], 
-                    label="Color Method", 
-                    value="optimized",
-                    info="Select the color processing method"
+                            ["optimized", "true", "mono", "color", "halfcolor", "dubois", "dubois_optimized"], 
+                            label="Color Method", 
+                            value="dubois",
+                            info="Select the color processing method"
                 )
-        
-                generate_btn = gr.Button("Generate 3D Image", variant="primary")
 
-                gr.Markdown("""
+            gr.Markdown("""
                 ### Methods:
                 - **anaglyph**: Creates a red-cyan 3D image (requires 3D glasses)
                 - **parallel**: Creates side-by-side images for parallel viewing
@@ -170,9 +190,10 @@ with gr.Blocks(css=css) as app:
                 - **mono**: Monochrome output
                 - **color**: Full color (may cause ghosting)
                 - **halfcolor**: Balance between color and depth
-                """)
-    
-            output = gr.Image(label="Generated 3D Anaglyph Image")
+            """)
+        
+        generate_btn = gr.Button("Generate 3D Image", variant="primary")
+        output = gr.Image(label="Generated 3D Anaglyph Image")
         
     generate_btn.click(
         fn=process_images,
@@ -182,4 +203,4 @@ with gr.Blocks(css=css) as app:
 
 # Launch the app
 if __name__ == "__main__":
-    app.launch()
+    app.launch(mcp_server=True)