This MCP server provides AI-powered travel planning tools specifically for Cox's Bazar, Bangladesh, combining weather data with intelligent itinerary generation.
Capabilities:
Generate AI-powered travel itineraries - Create detailed multi-day trip plans by specifying trip duration and start date (supports flexible formats like "2025-01-15", "15 Jan 2025", or "today"). The system automatically fetches daily temperature forecasts and generates comprehensive itineraries.
Get weather-based activity suggestions - Receive personalized activity recommendations tailored to specific temperature conditions and time of day (morning, afternoon, or evening).
Access weather forecasts - Retrieve temperature and detailed weather information for informed travel planning.
Use pre-configured travel prompts - Leverage built-in prompts for consistent and streamlined itinerary generation workflows.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Cox's Bazar AI Itinerary MCP Servergenerate a 3-day itinerary for Cox's Bazar with beach activities"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Production Ready MCP Boilerplate
Cox's Bazar AI Itinerary MCP Server
A Model Context Protocol (MCP) server that provides travel planning tools and weather information for Cox's Bazar, Bangladesh.
Features
Weather Tools: Get temperature forecasts and detailed weather information
Itinerary Tools: Generate AI-powered travel itineraries
Travel Prompts: Pre-configured prompts for travel planning
Getting Started
uv syncUsage
Run Inspector Tool
Need node version > 20.x.x
./scripts/run-inspector.shRun as installed command
This is serve the mcp server with auto-reload feature.
./scripts/run-mcp-server.shRequirements
Python 3.13+
Project Structure
.
├── src/
│ └── mcp_server/
│ ├── __init__.py
│ ├── server.py # Main server entry point
│ ├── mcp_instance.py # MCP instance configuration
│ ├── models/ # Pydantic models and schemas
│ │ ├── __init__.py
│ │ └── itinerary_models.py # Itinerary data models
│ ├── components/ # MCP components
│ │ ├── __init__.py
│ │ ├── tools/ # MCP tools
│ │ │ ├── __init__.py
│ │ │ ├── auth_additional.py # Additional authentication tool
│ │ │ └── itinerary.py # Travel itinerary tools
│ │ ├── resources/ # MCP resources
│ │ │ ├── __init__.py
│ │ │ └── weather.py # Weather data resources
│ │ └── prompts/ # MCP prompts
│ │ ├── __init__.py
│ │ └── travel_prompts.py # Travel planning prompts
│ ├── config/ # Configuration modules
│ │ ├── auth_provider.py # Authentication provider
│ │ └── custom_routes.py # Custom routes configuration
│ ├── core/ # Core functionality
│ │ ├── __init__.py
│ │ ├── prompts/
│ │ │ ├── __init__.py
│ │ │ └── travel.py # Travel prompt handlers
│ │ └── services/
│ │ └── itenerary_service.py # Itinerary business logic
│ └── utils/ # Utilities
│ ├── __init__.py
│ ├── elicitation.py # Elicitation utilities
│ ├── get_weather_forecast.py # Weather forecast utilities
│ └── helpers.py # Helper functions
├── scripts/ # Shell scripts
│ ├── run-inspector.sh # Run MCP inspector
│ └── run-mcp-server.sh # Run server script
├── tests/* # Test directory (unit, integration, fixtures)
├── _docs/* # Documentation files
├── Dockerfile # Docker configuration
├── glama.json # Glama configuration
├── pytest.ini # Pytest configuration
├── README.md # Project documentation
├── LICENSE # MIT License
├── pyproject.toml # Project configuration and dependencies
└── uv.lock # Dependency lock fileConnect to Claude Desktop
Option 1: Local Development (without Docker)
Add this configuration to your Claude Desktop config file (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):
{
"mcpServers": {
"coxs-bazar-itinerary-mcp": {
"command": "uv",
"args": [
"--directory",
"/Users/code4mk/Documents/GitHub/gumpper-group/mcp-explore/mcp-server-python-template",
"run",
"mcp-server"
]
}
}
}Option 2: Using Docker
First, build the Docker image:
docker build \
--platform=linux/amd64 \
--build-arg PYTHON_VERSION=3.12-slim \
-t cox-mcp-server .Then add this configuration to your Claude Desktop config file:
{
"mcpServers": {
"coxs-bazar-itinerary-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"cox-mcp-server"
]
}
}
}Option 3: Using uvx (Run directly from GitHub)
Add this configuration to your Claude Desktop config file:
{
"mcpServers": {
"coxs-bazar-itinerary-mcp": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/code4mk/coxs-bazar-itinerary-mcp-server.git",
"mcp-server"
]
}
}
}License
MIT