Spaces:

MCP-1st-Birthday
/

fleetmind-dispatch-ai

Running

App Files Files Community

mashrur950 commited on 26 days ago

Commit

3d451f2

1 Parent(s): c86bca5

feat: Implement FastAPI root endpoint with usage instructions and server status

Browse files

Files changed (1) hide show

app.py +129 -0

app.py CHANGED Viewed

@@ -39,6 +39,9 @@ logger = logging.getLogger(__name__)
 # Import the MCP server instance
 from server import mcp
 # ============================================================================
 # HUGGING FACE SPACE CONFIGURATION
@@ -48,6 +51,121 @@ from server import mcp
 HF_SPACE_PORT = int(os.getenv("PORT", 7860))
 HF_SPACE_HOST = os.getenv("HOST", "0.0.0.0")
 # ============================================================================
 # MAIN ENTRY POINT
 # ============================================================================
@@ -79,6 +197,17 @@ if __name__ == "__main__":
     try:
         # Run MCP server in SSE mode for HuggingFace Space
         mcp.run(
             transport="sse",
             host=HF_SPACE_HOST,

 # Import the MCP server instance
 from server import mcp
+from fastapi import FastAPI
+from fastapi.responses import HTMLResponse
+import uvicorn
 # ============================================================================
 # HUGGING FACE SPACE CONFIGURATION
 HF_SPACE_PORT = int(os.getenv("PORT", 7860))
 HF_SPACE_HOST = os.getenv("HOST", "0.0.0.0")
+# Create FastAPI app with root endpoint
+app = FastAPI(title="FleetMind MCP Server")
+@app.get("/", response_class=HTMLResponse)
+async def root():
+    """Root endpoint with usage instructions"""
+    return """
+    <!DOCTYPE html>
+    <html>
+    <head>
+        <title>FleetMind MCP Server</title>
+        <style>
+            body { font-family: Arial, sans-serif; max-width: 800px; margin: 50px auto; padding: 20px; line-height: 1.6; }
+            h1 { color: #2c3e50; }
+            h2 { color: #34495e; margin-top: 30px; }
+            code { background: #f4f4f4; padding: 2px 6px; border-radius: 3px; }
+            pre { background: #2c3e50; color: #ecf0f1; padding: 15px; border-radius: 5px; overflow-x: auto; }
+            .status { color: #27ae60; font-weight: bold; }
+            .endpoint { background: #3498db; color: white; padding: 10px; border-radius: 5px; margin: 10px 0; }
+            ul { margin-left: 20px; }
+        </style>
+    </head>
+    <body>
+        <h1>🚚 FleetMind MCP Server</h1>
+        <p class="status">✅ Server Status: RUNNING</p>
+        <h2>📡 MCP Endpoint</h2>
+        <div class="endpoint">
+            <strong>SSE Endpoint:</strong> <code>https://huggingface.co/spaces/MCP-1st-Birthday/fleetmind-dispatch-ai/sse</code>
+        </div>
+        <h2>🔧 How to Connect</h2>
+        <h3>From Claude Desktop:</h3>
+        <p>Add this to your <code>claude_desktop_config.json</code>:</p>
+        <pre>{
+  "mcpServers": {
+    "fleetmind": {
+      "command": "npx",
+      "args": [
+        "mcp-remote",
+        "https://huggingface.co/spaces/MCP-1st-Birthday/fleetmind-dispatch-ai/sse"
+      ]
+    }
+  }
+}</pre>
+        <h3>From Continue (VS Code):</h3>
+        <ol>
+            <li>Install Continue extension</li>
+            <li>Add FleetMind MCP server in settings</li>
+            <li>Use the SSE endpoint URL above</li>
+        </ol>
+        <h2>🛠️ Available Tools (18 Total)</h2>
+        <h3>Order Management:</h3>
+        <ul>
+            <li><code>geocode_address</code> - Convert addresses to GPS coordinates</li>
+            <li><code>calculate_route</code> - Find shortest route between locations</li>
+            <li><code>create_order</code> - Create new delivery orders</li>
+            <li><code>count_orders</code> - Count orders with filters</li>
+            <li><code>fetch_orders</code> - Retrieve orders with pagination</li>
+            <li><code>get_order_details</code> - Get complete order information</li>
+            <li><code>search_orders</code> - Search by customer/ID</li>
+            <li><code>get_incomplete_orders</code> - List active deliveries</li>
+            <li><code>update_order</code> - Update order details</li>
+            <li><code>delete_order</code> - Remove orders</li>
+        </ul>
+        <h3>Driver Management:</h3>
+        <ul>
+            <li><code>create_driver</code> - Onboard new drivers</li>
+            <li><code>count_drivers</code> - Count drivers with filters</li>
+            <li><code>fetch_drivers</code> - Retrieve drivers with pagination</li>
+            <li><code>get_driver_details</code> - Get driver info + location</li>
+            <li><code>search_drivers</code> - Search by name/plate/ID</li>
+            <li><code>get_available_drivers</code> - List available drivers</li>
+            <li><code>update_driver</code> - Update driver information</li>
+            <li><code>delete_driver</code> - Remove drivers</li>
+        </ul>
+        <h2>📊 Real-Time Resources (2 Total)</h2>
+        <ul>
+            <li><code>orders://all</code> - Live orders dataset (last 30 days)</li>
+            <li><code>drivers://all</code> - Live drivers dataset with locations</li>
+        </ul>
+        <h2>📖 Example Usage</h2>
+        <p>After connecting via Claude Desktop, try:</p>
+        <ul>
+            <li>"Create an urgent delivery order for Sarah at 456 Oak Ave, San Francisco"</li>
+            <li>"Show me all available drivers"</li>
+            <li>"Calculate route from downtown SF to Oakland Airport"</li>
+            <li>"How many pending orders do we have?"</li>
+        </ul>
+        <h2>🔗 Links</h2>
+        <ul>
+            <li><a href="https://github.com/mashrur-rahman-fahim/fleetmind-mcp">GitHub Repository</a></li>
+            <li><a href="https://huggingface.co/MCP-1st-Birthday">MCP 1st Birthday Hackathon</a></li>
+            <li><a href="https://modelcontextprotocol.io">Model Context Protocol Docs</a></li>
+        </ul>
+        <footer style="margin-top: 50px; padding-top: 20px; border-top: 1px solid #ddd; color: #7f8c8d;">
+            <p>🏆 <strong>Track 1: Building MCP Servers - Enterprise Category</strong></p>
+            <p>Built with ❤️ using <a href="https://github.com/jlowin/fastmcp">FastMCP</a></p>
+        </footer>
+    </body>
+    </html>
+    """
+# Mount MCP SSE endpoint
+# FastMCP will handle the /sse endpoint when we call mcp.run()
 # ============================================================================
 # MAIN ENTRY POINT
 # ============================================================================
     try:
         # Run MCP server in SSE mode for HuggingFace Space
+        # This will automatically mount the /sse endpoint to our FastAPI app
+        mcp.run(
+            transport="sse",
+            host=HF_SPACE_HOST,
+            port=HF_SPACE_PORT,
+            custom_app=app  # Use our custom FastAPI app with root endpoint
+        )
+    except TypeError:
+        # Fallback if FastMCP doesn't support custom_app
+        # Run both servers (not ideal but works)
+        logger.warning("Running without custom root endpoint")
         mcp.run(
             transport="sse",
             host=HF_SPACE_HOST,