# 🌐 Travel MCP Server

A reusable **Model Context Protocol (MCP)** server built with **Python** and the **MCP Python SDK**. It exposes travel-related tools that can be dynamically discovered and invoked by AI clients such as **Google ADK**, **Claude Desktop**, and other MCP-compatible applications.

---

## ✨ Features

- 🔌 Built using the **Model Context Protocol (MCP)**
- 🛠️ Exposes reusable travel tools
- 🌤️ Retrieves live weather information
- 📅 Provides the current date
- 🔍 Automatic tool discovery
- 🤖 Compatible with Google ADK and other MCP clients
- 🧩 Easily extensible with new travel services

---

## 🏗️ Architecture

```text
AI Client (Google ADK / Claude Desktop)
                │
                ▼
           MCP Client
                │
────────────────────────────────
                │
         Travel MCP Server
                │
      ┌─────────┴─────────┐
      ▼                   ▼
    Tool 1             Tool 2
                │
                ▼
        External APIs
```

---

## 🛠️ Available Tools

| Tool | Description |
|------|-------------|
| 🌤️ `get_weather(city)` | Returns the current weather for the specified city |
| 📅 `get_current_date()` | Returns today's date in a human-readable format |

---

## 🚀 Running the Server

Install dependencies:

```bash
uv sync
```

Start the MCP server:

```bash
uv run python server.py
```

---

## 🧰 Tech Stack

| Category | Technologies |
|----------|--------------|
| **Language** | Python |
| **Protocol** | Model Context Protocol (MCP) |
| **SDK** | MCP Python SDK |
| **Weather API** | Open-Meteo API |
| **Package Manager** | uv |

---

## 🔗 Related Project

This server is used by the **AI Multi-Agent Travel Planner** built with **Google ADK**.

**Repository:** https://github.com/jranjan01/agentic-travel-planner