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

Installation

uv sync

Usage

Run Inspector Tool

Need node version > 20.x.x

./scripts/run-inspector.sh

Run as installed command

uv run cox-mcp-server # script ./scripts/run-script.sh

Requirements

Python 3.13+
mcp[cli] >= 1.20.0
python-dateutil >= 2.9.0
requests >= 2.32.5

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_user.py # User 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 │ │ └── get_travel_prompts.py # Travel prompt handlers │ └── utils/ # Utilities │ ├── __init__.py │ ├── elicitation.py # Elicitation utilities │ ├── get_weather_forecast.py # Weather forecast utilities │ ├── helpers.py # Helper functions │ ├── types.py # Type definitions │ └── register_mcp_components.py # MCP component registration ├── scripts/ # Shell scripts │ ├── run-inspector.sh # Run MCP inspector │ └── run-script.sh # Run server script ├── tests/ # Test directory ├── _docs/ # Documentation files │ └── remote-mcp-connect.md # Remote MCP connection guide ├── cox-mcp.jpeg # Project image ├── Dockerfile # Docker configuration ├── glama.json # Glama configuration ├── README.md # Project documentation ├── license # MIT License ├── pyproject.toml # Project configuration and dependencies └── uv.lock # Dependency lock file

Connect 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", "cox-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", "cox-mcp-server" ] } } }

License

MIT

Cox's Bazar AI Itinerary MCP Server

Cox's Bazar AI Itinerary MCP Server

Features

Installation

Usage

Run Inspector Tool

Run as installed command

Requirements

Project Structure

Connect to Claude Desktop

Option 1: Local Development (without Docker)

Option 2: Using Docker

Option 3: Using uvx (Run directly from GitHub)

License

Related Resources

Tools

New MCP Servers

MCP directory API