Exely Hotel Booking MCP Assistant

<p align="right">Read this in other languages: <a href="./README.ru.md">Русский (Russian)</a></p> # Exely Hotel Booking MCP Assistant A project to integrate the Exely Distribution API with an LLM via an MCP server, allowing interaction through a Telegram bot. This project is containerized with Docker for easy and reliable deployment in a production environment on any server or VPS. ### Key Features - **One-Click Deployment**: Use the `deploy.sh` (for Linux) or `deploy.ps1` (for Windows) scripts for automatic installation and setup. - **Interactive Setup**: The scripts will prompt you for the necessary API keys and create the configuration files for you. - **Flexible**: You can deploy all components on a single machine or split the MCP server and Telegram bot across different servers. - **Production-Ready**: Uses a Multistage Docker build to create lightweight and secure images. - **Reliable**: Containers are configured to restart automatically in case of failure. ## Project structure ``` exely_mcp_project/ ├── app/ # Application source code (FastAPI/MCP server) │ ├── __init__.py │ ├── config.py # Application configuration (reads from .env files) │ ├── main.py # FastAPI entrypoint with the MCP server │ ├── exely_client/ # Client for the Exely API │ │ ├── __init__.py │ │ ├── client.py # The API client itself │ │ └── schemas.py # Pydantic models for the Exely API │ ├── llm_client/ # Client for the Mistral LLM API │ │ ├── __init__.py │ │ └── llm_client.py │ └── mcp_tools/ # MCP tools for the LLM │ ├── __init__.py │ ├── schemas_llm.py # Pydantic models for tool parameters │ ├── tools.py # Tool implementation logic │ └── prompt_utils.py # Utilities for generating prompts │ ├── telegram_bot.py # Telegram bot source code ├── pyproject.toml # Project dependencies and metadata │ ├── README.md # Main documentation (English) ├── README.ru.md # Optional documentation (Russian) │ │ --- Deployment Files --- ├── deploy.sh # Deployment script for Linux/macOS ├── deploy.ps1 # Deployment script for Windows (PowerShell) ├── Dockerfile # Instructions for building the Docker image ├── .dockerignore # Specifies files to exclude from the image ├── docker-compose.yml # Docker Compose for all-in-one deployment ├── docker-compose.server.yml # For deploying the server only ├── docker-compose.bot.yml # For deploying the bot only │ │ --- Environment Files (usually not in git) --- ├── .env.prod # (Generated) Production environment variables ├── .env.bot.prod # (Generated) Env vars for a remote bot └── .env.example # Template for local development (without Docker) ``` ## Deployment (Production) This is the recommended method for running the project on a VPS or any other server. ### Prerequisites - **Git** to clone the repository. - **Docker and Docker Compose**: The deployment script will attempt to automatically install them on Ubuntu systems. For other operating systems, please install them according to the official documentation. ### Launch Instructions 1. **Clone the repository to your server:** ```bash git clone https://github.com/Bdata0/Exely_MCP.git cd ~/Exely_MCP ``` 2. **Run the deployment script:** The script will check for Docker, prompt you for all required API keys and tokens, create the configuration files, and launch the project. * **For Linux (Ubuntu, Debian, etc.):** First, make the script executable: ```bash chmod +x deploy.sh ``` Then, run it: ```bash ./deploy.sh ``` * **For Windows (using PowerShell):** You may need to allow script execution for the current session: ```powershell Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process ``` Then, run the script: ```powershell .\deploy.ps1 ``` 3. **Follow the on-screen instructions:** * The script will ask you to enter your `EXELY_API_KEY`, `MISTRAL_API_KEY`, and `TELEGRAM_BOT_TOKEN`. Input will be hidden for security. * Next, it will prompt you to choose a deployment scenario: 1. **All-in-one**: Run both the server and the bot on the current machine (most common choice). 2. **Server only**: Run only the MCP server. 3. **Bot only**: Run only the Telegram bot (will require the IP address of the server machine). After selecting a scenario, the script will automatically build the Docker images and start the containers in the background. ### Application Management - **Check container status:** `docker compose ps` - **View real-time logs:** `docker compose logs -f` - **Stop the application:** `docker compose down` Your bot is now fully configured and running!