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.

Supports authentication provider integration with Auth0, enabling enterprise-grade authentication and authorization for MCP server access.

Provides optional authentication via Clerk OAuth provider, allowing secure access to MCP server tools and resources with configurable authentication settings.

Includes production-ready Docker configuration for containerized deployment, enabling easy deployment and scaling of the MCP server in containerized environments.

1. Click on "Install Server".

2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.

3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Cox's Bazar AI Itinerary MCP Server generate 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.

# Install dependencies
uv sync

# Copy environment variables and configure
cp .env.example .env

# (Optional) Install pre-commit git hooks
uv run pre-commit-install

uv run mcp-server-dev
# or
./scripts/run-mcp-server.sh

uv run mcp-inspector
# or
./scripts/run-inspector.sh

# Run lint + format via pre-commit
uv run lint

# Or run individually
./scripts/lint.sh # ruff check . --fix
./scripts/format.sh # ruff format .

./scripts/test.sh

docker build -t mcp-server .
docker run mcp-server

.
├── src/mcp_server/
│ ├── server.py # Main server entry point
│ ├── mcp_instance.py # FastMCP instance & auth config
│ ├── cli.py # CLI command definitions
│ ├── config/
│ │ ├── auth_provider.py # Auth provider factory
│ │ └── custom_routes.py # Custom HTTP routes
│ ├── handlers/ # MCP handler registrations (auto-discovered)
│ │ ├── tools/
│ │ │ ├── auth_additional.py
│ │ │ └── itinerary.py
│ │ ├── resources/
│ │ │ └── weather.py
│ │ └── prompts/
│ │ └── travel_prompts.py
│ ├── models/
│ │ └── itinerary_models.py # Pydantic models & schemas
│ ├── services/
│ │ └── itenerary_service.py # Business logic
│ ├── lib/
│ │ ├── clerk_auth_provider.py # Clerk OAuth provider
│ │ └── httpx_client.py # Async HTTP client wrapper
│ ├── prompt_templates/
│ │ └── travel.py # Prompt text builders
│ └── utils/
│ ├── elicitation.py
│ ├── get_weather_forecast.py
│ ├── helpers.py
│ └── http.py
├── tests/
│ ├── conftest.py
│ ├── fixtures/
│ │ ├── context.py
│ │ └── weather.py
│ ├── unit/
│ │ ├── test_auth_additional_tools.py
│ │ ├── test_auth_provider.py
│ │ ├── test_elicitation.py
│ │ ├── test_helpers.py
│ │ ├── test_itinerary_service_extra.py
│ │ ├── test_itinerary_tool_handler.py
│ │ ├── test_models.py
│ │ ├── test_server.py
│ │ ├── test_travel_prompts.py
│ │ ├── test_travel_prompts_handler.py
│ │ ├── test_weather_forecast.py
│ │ └── test_weather_resource.py
│ └── integration/
│ ├── test_itinerary_tool.py
│ └── test_weather_api.py
├── scripts/
│ ├── run-mcp-server.sh # Dev server with auto-reload
│ ├── run-inspector.sh # MCP Inspector launcher
│ ├── test.sh # Test runner
│ ├── lint.sh # Ruff lint --fix
│ ├── format.sh # Ruff format
│ └── generate-secrets.sh # Secret key generator
├── _docs/ # Documentation & ADRs
│ ├── adr/
│ │ ├── 001-choose-fastmcp.md
│ │ ├── 002-choose-httpx.md
│ │ └── ADR-template.md
│ ├── auth-provider-auth0.md
│ ├── httpx-client.md
│ ├── lint-formatting.md
│ ├── remote-mcp-connect.md
│ └── testing.md
├── .env.example # Environment variables template
├── .pre-commit-config.yaml # Pre-commit hook config
├── Dockerfile # Production Docker image
├── pyproject.toml # Project config & dependencies
├── ruff.toml # Ruff linter/formatter config
├── pytest.ini # Pytest configuration
├── glama.json # Glama registry config
└── LICENSE # MIT License