Upload app.py

app.py

@@ -462,7 +462,25 @@ MANUAL CORRECTION STEPS:
 -->"""
 
 def validate_rdf_interface(rdf_content: str, template: str, use_ai: bool = True):
-    """Main validation function for Gradio interface"""
+    """
+    Main validation function for Gradio interface and MCP server.
+    
+    This function provides comprehensive RDF/XML validation with AI-powered
+    suggestions and corrections. It serves as the primary interface for both
+    the Gradio web UI and MCP client tools.
+    
+    Args:
+        rdf_content (str): The RDF/XML content to validate
+        template (str): Validation template to use ('monograph' or 'custom')
+        use_ai (bool): Whether to enable AI-powered suggestions and corrections
+    
+    Returns:
+        tuple: (status, results_text, suggestions, corrected_rdf) containing:
+            - status: Validation status message
+            - results_text: Detailed validation results
+            - suggestions: AI or manual fix suggestions
+            - corrected_rdf: AI-generated corrections or success message
+    """
     if not rdf_content.strip():
         return "❌ Error", "No RDF/XML data provided", "", ""
     
@@ -493,13 +511,18 @@ def get_rdf_examples(example_type: str = "valid") -> str:
     Retrieve example RDF/XML snippets for testing and learning.
     
     This tool provides sample RDF/XML content that can be used to test
-    the validation system or learn proper RDF structure.
+    the validation system or learn proper RDF structure. Examples include
+    valid BibFrame Work records, invalid records for testing corrections,
+    and BibFrame Instance records.
     
     Args:
-        example_type (str): Type of example ('valid', 'invalid', or 'bibframe')
+        example_type (str): Type of example to retrieve. Options:
+            - 'valid': A complete, valid BibFrame Work record
+            - 'invalid': An incomplete BibFrame Work with validation errors
+            - 'bibframe': A BibFrame Instance record example
     
     Returns:
-        str: RDF/XML example content
+        str: Complete RDF/XML example content ready for validation testing
     """
     examples = {
         "valid": SAMPLE_VALID_RDF,
@@ -700,17 +723,36 @@ def create_interface():
         ### 🔧 **MCP Server Mode:**
         This app functions as both a web interface AND an MCP server for Claude Desktop and other MCP clients.
         
-        **Available MCP Tools (via SSE):**
+        **Available MCP Tools:**
         - `validate_rdf_tool`: Validate RDF/XML against SHACL shapes
         - `get_ai_suggestions`: Get AI-powered fix suggestions  
         - `get_ai_correction`: Generate corrected RDF/XML
         - `get_rdf_examples`: Retrieve example RDF snippets
+        - `validate_rdf_interface`: Complete validation with AI suggestions and corrections (primary tool)
+        
+        **MCP Configuration (Streamable HTTP):** 
+        Add this configuration to your MCP client (Claude Desktop, etc.):
         
-        **MCP Connection:** 
-        1. When deployed on Hugging Face Spaces, the MCP server is available at:
-           `https://your-space-id.hf.space/gradio_api/mcp/sse`
-        2. Use this URL in Claude Desktop's MCP configuration
-        3. The app automatically exposes functions with proper docstrings as MCP tools
+        ```json
+        {
+          "mcpServers": {
+            "rdf-validator": {
+              "url": "https://jimfhahn-mcp4rdf.hf.space/gradio_api/mcp/"
+            }
+          }
+        }
+        ```
+        
+        **Alternative SSE Configuration:**
+        ```json
+        {
+          "mcpServers": {
+            "rdf-validator": {
+              "url": "https://jimfhahn-mcp4rdf.hf.space/gradio_api/mcp/sse"
+            }
+          }
+        }
+        ```
         
         ### 💡 **Features:**
         - ✅ Real-time RDF/XML validation against SHACL schemas