Skip to main content
Glama
Virtuoso633

Travel Assistant MCP Server

by Virtuoso633
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

Travel Assistant MCP Server

A production-ready Model Context Protocol (MCP) server for intelligent travel planning.
It combines 16 powerful tools, live API integrations, database persistence, and a gamification system—perfect for the Vibe Summer Challenge 2025.

🌐 Live Deployment

Endpoint

URL

MCP Server

https://travel-assistant-mcp.virtuosoofcoding633.workers.dev/mcp

Health Check

https://travel-assistant-mcp.virtuosoofcoding633.workers.dev/health

Related MCP server: MCP Travel Planner

✨ Feature Highlights

  1. 16 MCP tools (weather, events, expenses, itinerary, gamification)

  2. Real APIs: FreeCurrencyAPI, Google Places, Open-Meteo, REST Countries

  3. Gamification: Points, levels, unlockable rewards

  4. Cloudflare Workers + D1 (SQLite) for serverless scale

  5. TypeScript + Hono.js + Drizzle ORM for type-safe development

  6. <7 ms average cold-start; sub-second responses

📁 Project Structure

travel-assistant-mcp/
├── src/
│   ├── index.ts               # Worker entry
│   ├── tools/                 # 16 MCP tool handlers
│   ├── db/                    # Drizzle schema & migrations
│   └── lib/                   # API helpers & gamification logic
├── drizzle.config.ts
├── wrangler.toml
├── package.json
├── .dev.vars.example
└── README.md

🚀 Quick Start

1. Clone & Install

git clone https://github.com/Virtuoso633/travel-assistant-mcp.git
cd travel-assistant-mcp
npm install

2. Environment Variables

cp .dev.vars.example .dev.vars
# Edit .dev.vars and add any API keys (optional – fallbacks provided)

3. Local Database & Dev Server

npm run db:generate     # create drizzle client
npm run db:migrate      # apply migrations locally
npm run dev             # wrangler dev --local (http://localhost:8787)

4. Test Locally

curl -X POST http://localhost:8787/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

🏗️ Deploy to Cloudflare

Login & Deploy

npx wrangler login                # OAuth or API token
npm run deploy                    # wrangler deploy

Remote Migration

npm run db:migrate:prod           # applies migrations to D1 prod DB

🔧 MCP Usage Examples

List Tools

curl -X POST https://travel-assistant-mcp.virtuosoofcoding633.workers.dev/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Create Itinerary

curl -X POST https://travel-assistant-mcp.virtuosoofcoding633.workers.dev/mcp \
  -H "Content-Type: application/json" \
  -d '{
        "jsonrpc":"2.0",
        "id":1,
        "method":"tools/call",
        "params":{
          "name":"create_itinerary",
          "arguments":{
            "destination":"Kyoto, Japan",
            "duration":3,
            "startDate":"2025-09-15",
            "interests":["culture","food"],
            "budget":"mid-range",
            "travelStyle":"solo",
            "userId":"demo_user"
          }
        }
      }'

🖥️ Claude Desktop Integration

  1. Create or edit:

    ~/.config/claude-desktop/claude_desktop_config.json

  2. Add:

    {
  "mcpServers": {
    "travel-assistant": {
      "command": "npx",
      "args": ["@modelcontextprotocol/server-http", "https://travel-assistant-mcp.virtuosoofcoding633.workers.dev/mcp"]
    }
  }
}

  3. Restart Claude Desktop and use prompts like:

    Plan a 5-day trip to Tokyo with a mid-range budget.

📜 API Reference (MCP)

tools/list

POST /mcp
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/list"
}

tools/call

POST /mcp
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "tool_name",
    "arguments": { /* tool-specific */ }
  }
}

🛠️ Scripts

npm run dev                # local Cloudflare Worker
npm run deploy             # deploy to Cloudflare
npm run db:generate        # generate drizzle client
npm run db:migrate         # migrate local DB
npm run db:migrate:prod    # migrate prod D1
npm run test               # MCP inspector
npm run lint               # eslint
npm run type-check         # TypeScript strict check

🌤️ 16 MCP Tools (Quick List)

Category

Tool

Description

Weather

get_weather

5-day forecast

compare_weather

Compare two locations

Events

find_events

Google Places search

save_event

Save place to plan

get_saved_places

List saved places

get_place_details

Detailed place info

Expenses

add_expense

Track expense with FX

convert_currency_live

Live conversion

get_live_exchange_rates

Multi-currency rates

get_expense_summary

Totals & breakdown

Itinerary

create_itinerary

AI travel plan

optimize_itinerary

Route/time optimizer

get_user_itineraries

List itineraries

get_itinerary_details

Itinerary detail

Gamification

get_user_progress

Points/levels

unlock_reward

Redeem reward

⚙️ Environment Variables (.dev.vars.example)

# ---------------- Required ----------------
DB_URL="file:./local.db"

# -------------- Optional Keys --------------
GOOGLE_MAPS_API_KEY=""
FREE_CURRENCY_API_KEY=""
BETTER_AUTH_SECRET=""

# -------------- Development ---------------
NODE_ENV="development"
DEBUG="true"

📖 Contributing

git checkout -b feature/amazing-feature
npm run lint && npm run type-check
git commit -m "Add amazing feature"
git push origin feature/amazing-feature
# open PR

📄 License

MIT — see LICENSE.

Built with ❤️ for the Vibe Summer Challenge 2025

Demo Video URL :: https://drive.google.com/drive/folders/1_xjZcIVCSt5ZB9I2UmvN1YusxnDJO3pq?usp=sharing

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers