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 sync

Usage

Run Inspector Tool

• Need node version > 20.x.x

./scripts/run-inspector.sh

Run as installed command

This is serve the mcp server with auto-reload feature.

./scripts/run-mcp-server.sh

Requirements

• 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 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",
        "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