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)

cd frontend
npm install
npm run dev

Starts on http://localhost:3000

MCP Server

The MCP server connects to the production Italy Transfers API.

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 - System design and components
• MCP Server - Claude integration guide
• Contributing - Development workflow

License

MIT

Support

For issues, questions, or contributions:

1. Check CONTRIBUTING.md
2. Review existing GitHub Issues
3. Submit a new issue with details