feat: implement native Gradio MCP server support

README.md

@@ -51,3 +51,29 @@ Ghost Dance protocol
 ## Copyright
 
 Copyright © 2025 ᓂᐲᔥ ᐙᐸᓂᒥᑮ-ᑭᓇᐙᐸᑭᓯ (Nbiish Waabanimikii-Kinawaabakizi), also known legally as JUSTIN PAUL KENWABIKISE, professionally documented as Nbiish-Justin Paul Kenwabikise, Anishinaabek Dodem (Anishinaabe Clan): Animikii (Thunder), a descendant of Chief ᑭᓇᐙᐸᑭᓯ (Kinwaabakizi) of the Beaver Island Band, and an enrolled member of the sovereign Grand Traverse Band of Ottawa and Chippewa Indians. This work embodies Traditional Knowledge and Traditional Cultural Expressions. All rights reserved.
+
+## MCP Server (AI Integration)
+
+GhostDance supports the Model Context Protocol (MCP). This allows AI tools like Cursor, Claude Desktop, or Cline to use the Ghost Dance calculation directly as a tool.
+
+### How to use in Cursor:
+
+1.  **Install Dependencies**: Ensure you have `gradio[mcp]` installed:
+    ```bash
+    pip install "gradio[mcp]"
+    ```
+2.  **Run the App**: Start the GhostDance application:
+    ```bash
+    python app.py
+    ```
+    The app will start the web UI and the MCP server. Look for the MCP SSE URL in the console (usually `http://127.0.0.1:7860/gradio_api/mcp/sse`).
+
+3.  **Configure Cursor**:
+    *   Open Cursor Settings.
+    *   Navigate to **Features** -> **MCP**.
+    *   Click **+ Add New MCP Server**.
+    *   **Name**: `GhostDance`
+    *   **Type**: `sse`
+    *   **URL**: `http://127.0.0.1:7860/gradio_api/mcp/sse`
+
+Once configured, you can ask Cursor to "Calculate Ghost Dance stride for a weight of 180 lbs" and it will use the tool automatically.

app.py

@@ -1,9 +1,4 @@
 import gradio as gr
-from fastmcp import FastMCP
-import sys
-
-# Create MCP server
-mcp = FastMCP("GhostDance")
 
 # Constants from the patent
 # Updated to match the patent more precisely: 50.909573606
@@ -36,23 +31,6 @@ def calculate_step(weight: float, unit: str):
         f"{half_feet:.3f} feet"
     )
 
-# Register MCP tool
-@mcp.tool()
-def ghost_dance_calculation(weight: float, unit: str = "pounds") -> str:
-    """
-    Calculate the required step length for the Ghost Dance.
-    
-    Args:
-        weight: Weight of the person.
-        unit: Unit of weight ('pounds' or 'kilograms').
-    """
-    full_m, full_f, half_m, half_f = calculate_step(weight, unit)
-    return (
-        f"To perform the Ghost Dance at your weight ({weight} {unit}):\n"
-        f"- Full Step (1.0s): {full_m} ({full_f})\n"
-        f"- Half Step (0.5s): {half_m} ({half_f})"
-    )
-
 # Gradio UI
 with gr.Blocks(title="Ghost Dance - A continued prophecy") as demo:
     gr.HTML("<h1 style='text-align: center;'>Ghost Dance - A continued prophecy</h1>")
@@ -105,8 +83,4 @@ with gr.Blocks(title="Ghost Dance - A continued prophecy") as demo:
     """)
 
 if __name__ == "__main__":
-    # Check for mcp argument
-    if len(sys.argv) > 1 and sys.argv[1] == "mcp":
-        mcp.run()
-    else:
-        demo.launch()
+    demo.launch(mcp_server=True)

pyproject.toml

@@ -6,7 +6,6 @@ readme = "README.md"
 requires-python = ">=3.13"
 dependencies = [
     "docling>=2.66.0",
-    "fastmcp>=2.14.2",
-    "gradio>=6.2.0",
+    "gradio[mcp]>=6.2.0",
     "streamlit>=1.40.2",
 ]

requirements.txt

@@ -1,4 +1,3 @@
-fastmcp>=2.14.2
-gradio>=6.2.0
+gradio[mcp]>=6.2.0
 streamlit>=1.40.2