Convert to documentation-only interface - remove all interactive components, show MCP API docs only - 2025-10-04 15:55:52

app.py

@@ -515,20 +515,131 @@ def get_property_usage(property_name: str, class_name: str = "") -> str:
     
     return json.dumps(usage, indent=2)
 
-# Create Gradio interface - MINIMAL VERSION to prevent crashes
+# Create Gradio interface - DOCUMENTATION ONLY (no interactive components)
 def create_interface():
     
     with gr.Blocks(title="BIBFRAME MCP Server") as demo:
-        gr.Markdown("""# 📚 BIBFRAME MCP Server
-        
-Query BIBFRAME ontology via MCP tools. Enter terms below.""")
-        
-        # Single simple interface without tabs to reduce load
-        property_input = gr.Textbox(label="Property or Class", placeholder="e.g., assigner, Work")
-        lookup_btn = gr.Button("Search")
-        output = gr.Textbox(label="Result", lines=15)
-        
-        lookup_btn.click(fn=get_property_info, inputs=[property_input], outputs=[output])
+        gr.Markdown(f"""
+# 📚 BIBFRAME Ontology MCP Server
+
+**Status:** ✅ Loaded {len(kb.properties)} properties and {len(kb.classes)} classes
+
+This is a **Model Context Protocol (MCP)** server providing BIBFRAME ontology documentation tools.
+The web interface is documentation only - use the MCP endpoint to query the ontology.
+
+---
+
+## 🔌 MCP Endpoint
+
+**SSE Endpoint:** `https://jimfhahn-mcp4bibframe-docs.hf.space/gradio_api/mcp/sse`
+
+---
+
+## 🛠️ Available MCP Tools
+
+### 1. `get_property_info`
+Get detailed information about a BIBFRAME property.
+
+**Input:** `property_uri` (string) - e.g., "assigner", "bf:assigner", or "title"
+
+**Returns:** JSON with property URI, label, definition, domain, range, examples, and usage notes
+
+**Example:**
+```json
+{{
+  "property": "bf:assigner",
+  "label": "Assigner",
+  "definition": "Entity who assigned the identifier or other metadata value",
+  "domain": ["bf:AdminMetadata"],
+  "range": ["bf:Agent"],
+  "examples": ["<bf:assigner rdf:resource='http://id.loc.gov/rwo/agents/n123'/>"]
+}}
+```
+
+---
+
+### 2. `get_class_info`
+Get detailed information about a BIBFRAME class.
+
+**Input:** `class_name` (string) - e.g., "Work", "bf:Work", or "Instance"
+
+**Returns:** JSON with class URI, label, definition, superclasses, and applicable properties
+
+**Example:**
+```json
+{{
+  "class": "bf:Work",
+  "label": "Work",
+  "definition": "Most abstract level of description for a creative concept",
+  "applicable_properties": [
+    {{"property": "bf:title", "label": "Title"}},
+    {{"property": "bf:contribution", "label": "Contribution"}}
+  ]
+}}
+```
+
+---
+
+### 3. `search_ontology`
+Search for properties or classes matching a term.
+
+**Inputs:**
+- `search_term` (string) - e.g., "title", "agent", "date"
+- `search_type` (string) - "all", "properties", or "classes"
+
+**Returns:** JSON with matching properties and classes (max 20 each)
+
+---
+
+### 4. `get_property_usage`
+Get usage information for a property in context of a specific class.
+
+**Inputs:**
+- `property_name` (string) - e.g., "assigner"
+- `class_name` (string, optional) - e.g., "AdminMetadata"
+
+**Returns:** JSON with usage information, examples, and context notes
+
+---
+
+## 🔧 Configuration
+
+### For Claude Desktop
+
+Add to `claude_desktop_config.json`:
+
+```json
+{{
+  "mcpServers": {{
+    "bibframe-docs": {{
+      "url": "https://jimfhahn-mcp4bibframe-docs.hf.space/gradio_api/mcp/sse"
+    }}
+  }}
+}}
+```
+
+### For Other MCP Clients
+
+Use the SSE endpoint URL above with your MCP client library.
+
+---
+
+## 📖 Data Source
+
+- **BIBFRAME Ontology:** [http://id.loc.gov/ontologies/bibframe.rdf](http://id.loc.gov/ontologies/bibframe.rdf)
+- **Official Documentation:** [https://www.loc.gov/bibframe/](https://www.loc.gov/bibframe/)
+
+---
+
+## 🔗 Related Tools
+
+- **SHACL Validator:** [mcp4rdf](https://huggingface.co/spaces/jimfhahn/mcp4rdf)
+- **BIBFRAME Profiles:** [LC BFE Profiles](https://github.com/lcnetdev/bfe-profiles)
+
+---
+
+*This server automatically loads the latest BIBFRAME ontology on startup.*
+        """)
     
     return demo