Metadata-Version: 2.4
Name: iflow-mcp_mcp-flight-search
Version: 0.2.0
Summary: Flight search service implementing  Model Context Protocol (MCP) tools
Author-email: Arjun Prabhulal <code.aicloudlab@gmail.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/arjunprabhulal/mcp-flight-search
Project-URL: Bug Tracker, https://github.com/arjunprabhulal/mcp-flight-search/issues
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: fastmcp
Requires-Dist: google-search-results
Requires-Dist: rich
Requires-Dist: pydantic
Requires-Dist: python-dotenv
Dynamic: license-file

# MCP Flight Search
<a href="https://glama.ai/mcp/servers/@arjunprabhulal/mcp-flight-search">
  <img width="380" height="200" src="https://glama.ai/mcp/servers/@arjunprabhulal/mcp-flight-search/badge" />
</a>

A flight search service built with Model Context Protocol (MCP). This service demonstrates how to implement MCP tools for flight search capabilities.

## What is Model Context Protocol?

The Model Context Protocol (MCP) is a standard developed by Anthropic that enables AI models to use tools by defining a structured format for tool descriptions, calls, and responses. This project implements MCP tools that can be used by Claude and other MCP-compatible models.

## Installation

```bash
# Install from PyPI
pip install mcp-flight-search

# Or install from the project directory (development mode)
pip install -e .
```

## Usage

Start the MCP server:

```bash
# Using the command-line entry point
mcp-flight-search --connection_type http

# Or run directly
python main.py --connection_type http
```

You can also specify a custom port:
```bash
python main.py --connection_type http --port 5000
```

## Environment Variables

Set the SerpAPI key as an environment variable:
```bash
export SERP_API_KEY="your-api-key-here"
```

## Features

- MCP-compliant tools for flight search functionality
- Integration with SerpAPI Google Flights
- Support for one-way and round-trip flights
- Rich logging with structured output
- Modular, maintainable code structure

## MCP Tools

This package provides the following Model Context Protocol tools:

- `search_flights_tool`: Search for flights between airports with parameters:
  - `origin`: Departure airport code (e.g., ATL, JFK)
  - `destination`: Arrival airport code (e.g., LAX, ORD)
  - `outbound_date`: Departure date (YYYY-MM-DD)
  - `return_date`: Optional return date for round trips (YYYY-MM-DD)

- `server_status`: Check if the MCP server is running

## Project Structure

```
mcp-flight-search/
├── mcp_flight_search/
│   ├── __init__.py              # Package initialization and exports
│   ├── config.py                # Configuration variables (API keys)
│   ├── models/
│   │   ├── __init__.py          # Models package init
│   │   └── schemas.py           # Pydantic models (FlightInfo)
│   ├── services/
│   │   ├── __init__.py          # Services package init
│   │   ├── search_service.py    # Main flight search logic
│   │   └── serpapi_client.py    # SerpAPI client wrapper
│   ├── utils/
│   │   ├── __init__.py          # Utils package init
│   │   └── logging.py           # Logging configuration
│   └── server.py                # MCP server setup and tool registration
├── main.py                      # Main entry point
├── pyproject.toml               # Python packaging configuration
├── LICENSE                      # MIT License
└── README.md                    # Project documentation
```

## Author

For more articles on AI/ML and Generative AI, follow me on Medium: https://medium.com/@arjun-prabhulal

## License

This project is licensed under the MIT License - see the LICENSE file for details. 
