🧭 Recovery Compass MCP Hub

AI-Powered Recovery Support with Hugging Face MCP Integration

🌟 Features

• 🔌 MCP Server Integration - Full Model Context Protocol support for AI assistants
• 🤖 AI Chat Support - 24/7 recovery guidance and support
• 🔍 Semantic Search - Find recovery resources, research papers, and support tools
• 📊 Progress Tracking - Monitor your recovery journey with AI insights
• 🌐 OAuth Login - Secure authentication with Hugging Face
• 🚀 REST API - Complete API for integration with other services

🚀 Quick Start

Access the Space

Visit https://huggingface.co/spaces/Recovery-Compass-79/README

API Endpoints

• GET / - Welcome page with OAuth login
• GET /health - Health check endpoint
• GET /mcp - MCP server capabilities
• GET /api/search?query={text} - Search HF resources
• GET /api/models?task={task} - List ML models
• GET /api/datasets?task={task} - List datasets
• GET /api/spaces - List recovery-related Spaces
• POST /api/chat - AI chat endpoint

Example API Call

# Search for recovery-related resources
curl "https://Recovery-Compass-79-README.hf.space/api/search?query=mental%20health"

# Get health check
curl "https://Recovery-Compass-79-README.hf.space/health"

# Chat with AI
curl -X POST "https://Recovery-Compass-79-README.hf.space/api/chat" \
  -H "Content-Type: application/json" \
  -d '{"message": "I need support today"}'

🔧 MCP Integration

This Space serves as an MCP server providing:

1. Semantic Search Tools - Find AI apps, papers, and documentation
2. Model Access - Discover and use ML models
3. Dataset Tools - Access recovery and mental health datasets
4. Space Integration - Connect to other support Spaces
5. Progress Tracking - Monitor recovery metrics

Connect with MCP Clients

Add this to your MCP client configuration:

{
  "mcpServers": {
    "recovery-compass": {
      "url": "https://huggingface.co/spaces/Recovery-Compass-79/README",
      "oauth": true
    }
  }
}

🔐 OAuth Setup

1. Visit the Space homepage
2. Click "Login with Hugging Face"
3. Authorize the application
4. Start using MCP tools

🛠️ Local Development

# Clone the repository
git clone https://huggingface.co/spaces/Recovery-Compass-79/README

# Install dependencies
pip install -r requirements.txt

# Run locally
uvicorn app:app --host 0.0.0.0 --port 7860

📚 Documentation

• Hugging Face MCP Server
• FastAPI Documentation
• Model Context Protocol

🤝 Contributing

Contributions are welcome! This is an open-source recovery support tool.

📄 License

MIT License - feel free to use and modify for your own recovery support projects.

⚠️ Disclaimer

This is an AI-powered support tool and should not replace professional medical or mental health care. If you're in crisis, please contact:

• National Suicide Prevention Lifeline: 988
• Crisis Text Line: Text HOME to 741741
• Emergency Services: 911

🌈 About Recovery Compass

Recovery Compass is an AI-powered platform designed to support individuals on their recovery journey. By integrating with Hugging Face's MCP ecosystem, we provide access to cutting-edge AI models, datasets, and tools to enhance recovery support.

---

Built with ❤️ using Hugging Face, FastAPI, and Model Context Protocol