|
|
""" |
|
|
FleetMind MCP Server - Hugging Face Space Entry Point (Track 1) |
|
|
|
|
|
This file serves as the entry point for HuggingFace Space deployment. |
|
|
Exposes 29 MCP tools via Server-Sent Events (SSE) endpoint for AI clients. |
|
|
|
|
|
Architecture: |
|
|
User → MCP Client (Claude Desktop, Continue, etc.) |
|
|
→ SSE Endpoint (this file) |
|
|
→ FleetMind MCP Server (server.py) |
|
|
→ Tools (chat/tools.py) |
|
|
→ Database (PostgreSQL) |
|
|
|
|
|
For Track 1: Building MCP Servers - Enterprise Category |
|
|
https://huggingface.co/MCP-1st-Birthday |
|
|
|
|
|
Compatible with: |
|
|
- Claude Desktop (via SSE transport) |
|
|
- Continue.dev (VS Code extension) |
|
|
- Cline (VS Code extension) |
|
|
- Any MCP client supporting SSE protocol |
|
|
""" |
|
|
|
|
|
import os |
|
|
import sys |
|
|
import logging |
|
|
from pathlib import Path |
|
|
|
|
|
|
|
|
sys.path.insert(0, str(Path(__file__).parent)) |
|
|
|
|
|
|
|
|
logging.basicConfig( |
|
|
level=logging.INFO, |
|
|
format='%(asctime)s - %(name)s - %(levelname)s - %(message)s', |
|
|
handlers=[logging.StreamHandler()] |
|
|
) |
|
|
logger = logging.getLogger(__name__) |
|
|
|
|
|
|
|
|
from server import mcp |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
HF_SPACE_PORT = int(os.getenv("PORT", 7860)) |
|
|
HF_SPACE_HOST = os.getenv("HOST", "0.0.0.0") |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
if __name__ == "__main__": |
|
|
logger.info("=" * 70) |
|
|
logger.info("FleetMind MCP Server - HuggingFace Space (Track 1)") |
|
|
logger.info("=" * 70) |
|
|
logger.info("MCP Server: FleetMind Dispatch Coordinator v1.0.0") |
|
|
logger.info("Protocol: Model Context Protocol (MCP)") |
|
|
logger.info("Transport: Server-Sent Events (SSE)") |
|
|
logger.info(f"SSE Endpoint: https://mcp-1st-birthday-fleetmind-dispatch-ai.hf.space/sse") |
|
|
logger.info("=" * 70) |
|
|
logger.info("Features:") |
|
|
logger.info(" ✓ 29 AI Tools (Order + Driver + Assignment Management)") |
|
|
logger.info(" ✓ 2 Real-Time Resources (orders://all, drivers://all)") |
|
|
logger.info(" ✓ Gemini 2.0 Flash AI - Intelligent Assignment") |
|
|
logger.info(" ✓ Google Maps API Integration (Routes + Geocoding)") |
|
|
logger.info(" ✓ Weather-Aware Routing (OpenWeatherMap)") |
|
|
logger.info(" ✓ PostgreSQL Database (Neon)") |
|
|
logger.info("=" * 70) |
|
|
logger.info("Compatible Clients:") |
|
|
logger.info(" • Claude Desktop") |
|
|
logger.info(" • Continue.dev (VS Code)") |
|
|
logger.info(" • Cline (VS Code)") |
|
|
logger.info(" • Any MCP-compatible client") |
|
|
logger.info("=" * 70) |
|
|
logger.info("How to Connect (Claude Desktop):") |
|
|
logger.info(' Add to claude_desktop_config.json:') |
|
|
logger.info(' {') |
|
|
logger.info(' "mcpServers": {') |
|
|
logger.info(' "fleetmind": {') |
|
|
logger.info(' "command": "npx",') |
|
|
logger.info(' "args": [') |
|
|
logger.info(' "mcp-remote",') |
|
|
logger.info(' "https://mcp-1st-birthday-fleetmind-dispatch-ai.hf.space/sse"') |
|
|
logger.info(' ]') |
|
|
logger.info(' }') |
|
|
logger.info(' }') |
|
|
logger.info(' }') |
|
|
logger.info("=" * 70) |
|
|
logger.info(f"Starting SSE server on {HF_SPACE_HOST}:{HF_SPACE_PORT}...") |
|
|
logger.info("Waiting for MCP client connections...") |
|
|
logger.info("=" * 70) |
|
|
|
|
|
try: |
|
|
|
|
|
from starlette.responses import HTMLResponse |
|
|
|
|
|
@mcp.custom_route("/", methods=["GET"]) |
|
|
async def landing_page(request): |
|
|
"""Landing page with MCP connection information""" |
|
|
return HTMLResponse(""" |
|
|
<!DOCTYPE html> |
|
|
<html> |
|
|
<head> |
|
|
<title>FleetMind MCP Server</title> |
|
|
<style> |
|
|
body { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Arial, sans-serif; max-width: 1000px; margin: 50px auto; padding: 20px; background: #0f172a; color: #e2e8f0; } |
|
|
.container { background: #1e293b; padding: 40px; border-radius: 12px; box-shadow: 0 8px 16px rgba(0,0,0,0.4); } |
|
|
h1 { color: #f1f5f9; margin-top: 0; } |
|
|
h2 { color: #e2e8f0; border-bottom: 2px solid #334155; padding-bottom: 10px; } |
|
|
h3 { color: #cbd5e1; } |
|
|
code { background: #334155; color: #60a5fa; padding: 3px 8px; border-radius: 4px; font-family: 'Courier New', monospace; } |
|
|
pre { background: #0f172a; color: #f1f5f9; padding: 20px; border-radius: 8px; overflow-x: auto; border: 1px solid #334155; } |
|
|
.endpoint { background: #1e3a5f; padding: 15px; margin: 15px 0; border-left: 4px solid #3b82f6; border-radius: 4px; } |
|
|
.feature { background: #134e4a; padding: 15px; margin: 10px 0; border-left: 4px solid #10b981; border-radius: 4px; } |
|
|
.badge { display: inline-block; background: #3b82f6; color: white; padding: 4px 12px; border-radius: 12px; font-size: 12px; margin: 5px; } |
|
|
a { color: #60a5fa; text-decoration: none; } |
|
|
a:hover { text-decoration: underline; color: #93c5fd; } |
|
|
ol { line-height: 1.8; } |
|
|
ul { line-height: 1.8; } |
|
|
p { color: #cbd5e1; } |
|
|
</style> |
|
|
</head> |
|
|
<body> |
|
|
<div class="container"> |
|
|
<h1>🚚 FleetMind MCP Server</h1> |
|
|
<p><strong>Enterprise Model Context Protocol Server for AI-Powered Delivery Dispatch</strong></p> |
|
|
<p><span class="badge">MCP 1st Birthday Hackathon</span> <span class="badge">Track 1: Building MCP</span> <span class="badge">Enterprise Category</span></p> |
|
|
|
|
|
<hr style="margin: 30px 0; border: none; border-top: 1px solid #e5e7eb;"> |
|
|
|
|
|
<h2>🔌 MCP Server Connection</h2> |
|
|
|
|
|
<div class="endpoint"> |
|
|
<strong>SSE Endpoint URL:</strong><br> |
|
|
<code>https://mcp-1st-birthday-fleetmind-dispatch-ai.hf.space/sse</code> |
|
|
</div> |
|
|
|
|
|
<h3>⚙️ Claude Desktop Configuration</h3> |
|
|
<p>Add this to your <code>claude_desktop_config.json</code> file:</p> |
|
|
<pre>{ |
|
|
"mcpServers": { |
|
|
"fleetmind": { |
|
|
"command": "npx", |
|
|
"args": [ |
|
|
"mcp-remote", |
|
|
"https://mcp-1st-birthday-fleetmind-dispatch-ai.hf.space/sse" |
|
|
] |
|
|
} |
|
|
} |
|
|
}</pre> |
|
|
|
|
|
<h3>📋 How to Connect</h3> |
|
|
<ol> |
|
|
<li>Install <a href="https://claude.ai/download" target="_blank">Claude Desktop</a></li> |
|
|
<li>Locate your <code>claude_desktop_config.json</code> file</li> |
|
|
<li>Add the configuration shown above</li> |
|
|
<li>Restart Claude Desktop</li> |
|
|
<li>Look for "FleetMind" in the 🔌 tools menu</li> |
|
|
</ol> |
|
|
|
|
|
<hr style="margin: 30px 0; border: none; border-top: 1px solid #e5e7eb;"> |
|
|
|
|
|
<h2>🛠️ Available Tools (29 Total)</h2> |
|
|
|
|
|
<div class="feature"> |
|
|
<strong>📍 Geocoding & Routing (3 tools):</strong><br> |
|
|
geocode_address, calculate_route, calculate_intelligent_route |
|
|
</div> |
|
|
|
|
|
<div class="feature"> |
|
|
<strong>📦 Order Management (8 tools):</strong><br> |
|
|
create_order, count_orders, fetch_orders, get_order_details, search_orders, get_incomplete_orders, update_order, delete_order |
|
|
</div> |
|
|
|
|
|
<div class="feature"> |
|
|
<strong>👥 Driver Management (8 tools):</strong><br> |
|
|
create_driver, count_drivers, fetch_drivers, get_driver_details, search_drivers, get_available_drivers, update_driver, delete_driver |
|
|
</div> |
|
|
|
|
|
<div class="feature"> |
|
|
<strong>🔗 Assignment Management (8 tools):</strong><br> |
|
|
create_assignment, <strong>auto_assign_order</strong>, <strong>intelligent_assign_order</strong>, get_assignment_details, update_assignment, unassign_order, complete_delivery, fail_delivery |
|
|
</div> |
|
|
|
|
|
<div class="feature"> |
|
|
<strong>🗑️ Bulk Operations (2 tools):</strong><br> |
|
|
delete_all_orders, delete_all_drivers |
|
|
</div> |
|
|
|
|
|
<hr style="margin: 30px 0; border: none; border-top: 1px solid #e5e7eb;"> |
|
|
|
|
|
<h2>⭐ Key Features</h2> |
|
|
<ul> |
|
|
<li><strong>🧠 Gemini 2.0 Flash AI</strong> - Intelligent order assignment with detailed reasoning</li> |
|
|
<li><strong>🌦️ Weather-Aware Routing</strong> - Safety-first delivery planning with OpenWeatherMap</li> |
|
|
<li><strong>🚦 Real-Time Traffic</strong> - Google Routes API integration with live traffic data</li> |
|
|
<li><strong>📊 SLA Tracking</strong> - Automatic on-time performance monitoring</li> |
|
|
<li><strong>🗄️ PostgreSQL Database</strong> - Production-grade data storage (Neon)</li> |
|
|
<li><strong>🚀 Multi-Client Support</strong> - Works with Claude Desktop, Continue, Cline, any MCP client</li> |
|
|
</ul> |
|
|
|
|
|
<hr style="margin: 30px 0; border: none; border-top: 1px solid #e5e7eb;"> |
|
|
|
|
|
<h2>📚 Resources</h2> |
|
|
<ul> |
|
|
<li><strong>GitHub:</strong> <a href="https://github.com/mashrur-rahman-fahim/fleetmind-mcp" target="_blank">mashrur-rahman-fahim/fleetmind-mcp</a></li> |
|
|
<li><strong>HuggingFace Space:</strong> <a href="https://huggingface.co/spaces/MCP-1st-Birthday/fleetmind-dispatch-ai" target="_blank">MCP-1st-Birthday/fleetmind-dispatch-ai</a></li> |
|
|
<li><strong>MCP Protocol Docs:</strong> <a href="https://modelcontextprotocol.io" target="_blank">modelcontextprotocol.io</a></li> |
|
|
</ul> |
|
|
|
|
|
<hr style="margin: 30px 0; border: none; border-top: 1px solid #e5e7eb;"> |
|
|
|
|
|
<p style="text-align: center; color: #6b7280; font-size: 14px;"> |
|
|
FleetMind v1.0 - Built for MCP 1st Birthday Hackathon<br> |
|
|
29 AI Tools | 2 Real-Time Resources | Enterprise-Ready |
|
|
</p> |
|
|
</div> |
|
|
</body> |
|
|
</html> |
|
|
""") |
|
|
|
|
|
logger.info("[OK] Landing page added at / route") |
|
|
logger.info("[OK] MCP SSE endpoint available at /sse") |
|
|
|
|
|
|
|
|
mcp.run( |
|
|
transport="sse", |
|
|
host=HF_SPACE_HOST, |
|
|
port=HF_SPACE_PORT |
|
|
) |
|
|
|
|
|
except Exception as e: |
|
|
logger.error(f"Failed to start server: {e}") |
|
|
logger.error("Check that:") |
|
|
logger.error(" 1. Database connection is configured (DB_HOST, DB_USER, etc.)") |
|
|
logger.error(" 2. Google Maps API key is set (GOOGLE_MAPS_API_KEY)") |
|
|
logger.error(" 3. Port 7860 is available") |
|
|
raise |
|
|
|
