Hostaway MCP Server

# Docker Quick Start Guide ## Prerequisites - Docker Desktop installed and running - Hostaway API credentials (Account ID and Secret Key) ## Method 1: Docker Compose (Recommended) ### 1. Verify Configuration Check that your `.env` file has the correct credentials: ```bash cat .env ``` Should contain: ```bash HOSTAWAY_ACCOUNT_ID=your_account_id HOSTAWAY_SECRET_KEY=your_secret_key ``` ### 2. Build and Start ```bash # Build and start in detached mode docker compose up -d --build # View logs docker compose logs -f hostaway-mcp ``` ### 3. Verify Deployment ```bash # Check health curl http://localhost:8000/health # View API docs open http://localhost:8000/docs # Test a real endpoint curl http://localhost:8000/api/listings?limit=3 ``` ### 4. Stop/Restart ```bash # Stop docker compose down # Restart docker compose restart # View container status docker compose ps ``` ## Method 2: Docker Standalone ### 1. Build Image ```bash docker build -t hostaway-mcp:latest . ``` ### 2. Run Container ```bash docker run -d \ --name hostaway-mcp \ -p 8000:8000 \ --env-file .env \ --restart unless-stopped \ hostaway-mcp:latest ``` ### 3. View Logs ```bash docker logs -f hostaway-mcp ``` ### 4. Stop Container ```bash docker stop hostaway-mcp docker rm hostaway-mcp ``` ## Troubleshooting ### Issue: Container exits immediately **Check logs:** ```bash docker compose logs hostaway-mcp ``` **Common causes:** 1. Missing environment variables → Check `.env` file 2. Invalid credentials → Verify Hostaway API credentials 3. Port conflict → Kill process on port 8000: `lsof -ti :8000 | xargs kill -9` ### Issue: Health check failing **Test health endpoint manually:** ```bash docker exec hostaway-mcp-server curl http://localhost:8000/health ``` ### Issue: Can't access from browser **Check if container is running:** ```bash docker ps | grep hostaway-mcp ``` **Check port mapping:** ```bash docker port hostaway-mcp-server ``` Should show: `8000/tcp -> 0.0.0.0:8000` ## Production-Like Setup (with Nginx) Uncomment the nginx service in `docker-compose.yml` for a production-like setup with reverse proxy: ```bash # Edit docker-compose.yml (uncomment nginx section) # Then start both services docker compose up -d ``` This will expose: - Port 80 (HTTP) → routed to MCP server - Port 443 (HTTPS) → requires SSL certificates ## Performance Tips 1. **Use volumes for logs:** - Logs are automatically mounted to `./logs/` directory - Check them with: `tail -f logs/app.log | jq` 2. **Monitor resource usage:** ```bash docker stats hostaway-mcp-server ``` 3. **Restart on configuration change:** ```bash docker-compose restart ``` ## Next Steps 1. ✅ Verify all endpoints work: http://localhost:8000/docs 2. ✅ Test MCP tool discovery (if using Claude Desktop) 3. ✅ Check logs for any errors: `docker-compose logs -f` 4. 🚀 Deploy to production using the same Docker image ## Recommended Workflow ```bash # 1. Start services docker compose up -d # 2. Tail logs in one terminal docker compose logs -f # 3. Test in another terminal curl http://localhost:8000/health # 4. When done docker compose down ```