mcpField
🏠
🏠 Airbnb Search Assistant

🏠 Airbnb Search Assistant

github.com/akktrsstFrameworks & SDKs6Updated 80w ago

About 🏠 Airbnb Search Assistant

A Gradio-based chatbot application that helps users find accommodations worldwide using AI-powered search. It filters properties by amenities, provides personalized recommendations, and falls back to basic chat if the MCP connection fails.

Key features

  1. 01AI-powered property search and recommendations
  2. 02Filter by amenities and preferences
  3. 03Worldwide accommodation search
  4. 04Interactive chat interface
  5. 05Responsive design

Use cases

  1. 01Finding beachfront villas for specific group sizes
  2. 02Searching pet-friendly houses with particular features
  3. 03Discovering luxury apartments near landmarks

MCP support

The client connects to the Airbnb MCP server to access property listings and search capabilities.

Details

From the project README

🏠 Airbnb Search Assistant

A Gradio-based chatbot application that helps users find their perfect accommodation using AI-powered search capabilities. The assistant can search for properties worldwide, filter by amenities, and provide personalized recommendations.

Airbnb Search Assistant Python

✨ Features

  • 🎨 Beautiful, Airbnb-inspired UI with custom styling
  • πŸ” AI-powered property search and recommendations
  • 🌍 Worldwide property search capabilities
  • 🏑 Filter by amenities and preferences
  • πŸ’¬ Interactive chat interface
  • πŸ”„ Automatic fallback to basic chat mode if MCP connection fails
  • πŸ“± Responsive design for all devices

πŸš€ Getting Started

Prerequisites
  • Python 3.10 or higher
  • Node.js (for MCP server)
  • OpenAI API key
Installation
  1. Clone the repository:
git clone [email protected]:akktrsst/MCP_Agent_Airbnb.git
  1. Install Python dependencies:
pip install -r requirements.txt
  1. Install MCP server:
npm install -g @openbnb/mcp-server-airbnb
  1. Create a .env file in the examples directory with your API keys:
OPENAI_API_KEY=your_openai_api_key
Running the Application
  1. Start the Streamlit app:
python chatbot.py
  1. Open your browser and navigate to:
http://localhost:XXXX

πŸ’‘ Usage

  1. Enter your search query in the chat input, for example:

    • "Find me a beachfront villa in Bali for 4 people"
    • "Show luxury apartments in Paris with Eiffel Tower views"
    • "Search for pet-friendly houses in London with a garden"
  2. The assistant will provide detailed responses about properties, including:

    • Amenities
    • Location benefits
    • Pricing information
    • Reviews and ratings
  3. Use the "Clear Chat" button to start a new conversation

πŸ› οΈ Technical Details

Architecture
  • Frontend: Streamlit
  • Backend: Python with LangChain
  • AI Model: GPT-4o-mini
  • MCP Integration: Airbnb MCP Server
Key Components
  • chatbot.py: Main application file
  • airbnb_mcp.json: MCP server configuration
  • Custom CSS styling for Airbnb-like interface
  • Error handling and fallback mechanisms

🀝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

πŸ“ License

This project is licensed under the MIT License - see the LICENSE file for details.

πŸ™ Acknowledgments

πŸ“ž Support

For support, please open an issue in the repository or contact the maintainers.


Made with ❀️ by [Abhishek Kumar]

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.