Fix HuggingFace Spaces configuration in README.md - 2025-10-04 15:16:48

README.md

@@ -1,3 +1,14 @@
+---
+title: BIBFRAME Ontology Documentation MCP Server
+emoji: 📚
+colorFrom: blue
+colorTo: green
+sdk: gradio
+sdk_version: "5.0.0"
+app_file: app.py
+pinned: false
+---
+
 # 📚 BIBFRAME Ontology Documentation MCP Server
 
 A Model Context Protocol (MCP) server that provides BIBFRAME ontology documentation for LLMs like Claude. Built with Gradio, this server dynamically loads from the official BIBFRAME ontology at id.loc.gov.

app.py

@@ -33,12 +33,38 @@ class BIBFRAMEKnowledgeBase:
         self.classes = {}
         self._loaded = False
         
-    @lru_cache(maxsize=1)
     def load_ontology(self):
         """Load the BIBFRAME ontology from the official source"""
+        if self._loaded:
+            return
+            
         try:
             print("📚 Loading BIBFRAME ontology from id.loc.gov...")
-            self.ontology_graph.parse("http://id.loc.gov/ontologies/bibframe.rdf", format="xml")
+            
+            # Try with requests first for better error handling
+            headers = {
+                'User-Agent': 'BIBFRAME-MCP-Server/1.0 (https://github.com/your-repo)'
+            }
+            
+            try:
+                response = requests.get(
+                    "http://id.loc.gov/ontologies/bibframe.rdf", 
+                    headers=headers, 
+                    timeout=30
+                )
+                response.raise_for_status()
+                
+                # Parse from string
+                self.ontology_graph.parse(data=response.text, format="xml")
+                print("📚 Successfully downloaded and parsed BIBFRAME ontology")
+                
+            except requests.exceptions.RequestException as req_e:
+                print(f"⚠️ HTTP request failed: {req_e}")
+                # Fallback to direct parsing
+                self.ontology_graph.parse(
+                    "http://id.loc.gov/ontologies/bibframe.rdf", 
+                    format="xml"
+                )
             
             # Extract properties
             for prop in self.ontology_graph.subjects(RDF.type, RDF.Property):
@@ -69,6 +95,7 @@ class BIBFRAMEKnowledgeBase:
             
         except Exception as e:
             print(f"⚠️ Error loading ontology: {e}")
+            print(f"⚠️ Error type: {type(e).__name__}")
             print("📦 Using minimal fallback data")
             self._load_minimal_fallback()
     
@@ -82,9 +109,34 @@ class BIBFRAMEKnowledgeBase:
                 "domain": ["http://id.loc.gov/ontologies/bibframe/AdminMetadata"],
                 "range": ["http://id.loc.gov/ontologies/bibframe/Agent"],
                 "subPropertyOf": []
+            },
+            "bf:title": {
+                "uri": "http://id.loc.gov/ontologies/bibframe/title",
+                "label": "Title",
+                "definition": "Title information relating to a resource",
+                "domain": ["http://id.loc.gov/ontologies/bibframe/Work", "http://id.loc.gov/ontologies/bibframe/Instance"],
+                "range": ["http://id.loc.gov/ontologies/bibframe/Title"],
+                "subPropertyOf": []
             }
         }
+        
+        self.classes = {
+            "bf:Work": {
+                "uri": "http://id.loc.gov/ontologies/bibframe/Work",
+                "label": "Work",
+                "definition": "Most abstract level of description for a creative concept",
+                "subClassOf": ["http://id.loc.gov/ontologies/bibframe/Resource"]
+            },
+            "bf:Instance": {
+                "uri": "http://id.loc.gov/ontologies/bibframe/Instance",
+                "label": "Instance",
+                "definition": "Individual exemplar of a Work",
+                "subClassOf": ["http://id.loc.gov/ontologies/bibframe/Resource"]
+            }
+        }
+        
         self._loaded = True
+        print("📦 Loaded fallback data: 2 properties, 2 classes")
     
     def _get_label(self, resource):
         return str(self.ontology_graph.value(resource, RDFS.label) or "")