# Italy Transfers

Real-time train, bus, ferry and private transfer prices across Italian cities.

This package includes:
- **Frontend**: Next.js 14 with i18n support (7 languages)
- **MCP Server**: Claude MCP server for real-time price searches
- **Documentation**: Architecture, research, and supplier information

## Quick Start

### Frontend (Next.js)

```bash
cd frontend
npm install
npm run dev
```

Starts on http://localhost:3000

### MCP Server

The MCP server connects to the production Italy Transfers API.

```bash
cd mcp
# See mcp/README.md for deployment instructions
```

## Project Structure

```
italy-transfer/
├── frontend/          # Next.js 14 app with next-intl
│   ├── app/          # App router pages
│   ├── components/   # React components
│   ├── lib/          # Utilities (price formatting, routing)
│   ├── messages/     # i18n translations (en, it, de, fr, es, ru, pt)
│   └── public/       # Static assets
├── mcp/              # Claude MCP server
│   ├── server.py     # MCP implementation
│   ├── .mcp.json     # MCP metadata
│   └── README.md     # Deployment guide
└── docs/             # Documentation
    ├── ARCHITECTURE.md
    ├── research/     # SEO and market research
    └── suppliers/    # Supplier integrations
```

## Features

**Frontend:**
- Real-time price search across 71+ Italian transport routes
- Multi-language support (EN, IT, DE, FR, ES, RU, PT)
- SEO-optimized static and incremental static regeneration
- Mobile-responsive Tailwind CSS design

**MCP Server:**
- `search_italy_transport` - Search routes with live prices
- `list_italy_routes` - List all 71+ available routes
- `get_route_info` - Detailed price and time info
- `get_cheapest_travel_day` - Find best travel day

## Supported Routes

- Rome, Milan, Florence, Venice, Naples, Palermo, Genoa, Turin, Bologna, Verona
- All major airports (FCO, MXP, VCE, BGY, NAP)
- Interconnected routes: 71+ popular destinations

## Development

**Language**: TypeScript (frontend), Python (MCP)
**Framework**: Next.js 14, FastMCP
**Styling**: Tailwind CSS
**i18n**: next-intl

## Documentation

- [Architecture](./docs/ARCHITECTURE.md) - System design and components
- [MCP Server](./mcp/README.md) - Claude integration guide
- [Contributing](./CONTRIBUTING.md) - Development workflow

## License

MIT

## Support

For issues, questions, or contributions:
1. Check [CONTRIBUTING.md](./CONTRIBUTING.md)
2. Review existing [GitHub Issues](https://github.com/trendbender/italy-transfer/issues)
3. Submit a new issue with details