google-flights-mcp-server 0.1.1

package/README.md

@@ -0,0 +1,129 @@
+# Google Flights MCP Server
+
+> **Note**: This package is part of the [MCP Servers](https://github.com/pulsemcp/mcp-servers) monorepo. For the latest updates and full source code, visit the [Google Flights MCP Server directory](https://github.com/pulsemcp/mcp-servers/tree/main/experimental/google-flights).
+
+
+MCP server for searching Google Flights. Provides flight search, date-price grids for finding cheapest travel dates, and airport IATA code lookup. No API key required.
+
+## Highlights
+
+- Flight search with full filtering (cabin class, stops, sorting, pagination)
+- Date-price grid for finding cheapest travel dates across ~60 days
+- Airport IATA code lookup by city name, airport name, or partial code
+- No API key or authentication required
+- Multi-passenger support (adults, children, infants)
+- Multiple currency support
+- Built-in rate limiting to avoid throttling
+- TypeScript with strict type checking
+
+## Capabilities
+
+### Tools
+
+| Tool                | Description                                                            |
+| ------------------- | ---------------------------------------------------------------------- |
+| `search_flights`    | Search for flights with full filtering, sorting, and pagination        |
+| `get_date_grid`     | Get a date-price grid showing the cheapest flight price for each day   |
+| `find_airport_code` | Look up airport IATA codes by city name, airport name, or partial code |
+
+### Resources
+
+| Resource                  | Description                              |
+| ------------------------- | ---------------------------------------- |
+| `google-flights://config` | Server configuration and available tools |
+
+## Quick Start
+
+### Claude Desktop Configuration
+
+If this is your first time using MCP Servers, make sure you have the [Claude Desktop application](https://claude.ai/download) and follow the [official MCP setup instructions](https://modelcontextprotocol.io/quickstart/user).
+
+macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
+
+Windows: `%APPDATA%\Claude\claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "google-flights": {
+      "command": "npx",
+      "args": ["-y", "google-flights-mcp-server"]
+    }
+  }
+}
+```
+
+Restart Claude Desktop and you should be ready to go!
+
+### Example Usage
+
+Search for flights:
+
+```
+"Find me the cheapest nonstop flights from SFO to LAX next Friday"
+```
+
+Find cheapest dates:
+
+```
+"When is the cheapest time to fly from JFK to London in March?"
+```
+
+Look up airport codes:
+
+```
+"What are the airport codes for Tokyo?"
+```
+
+## Development
+
+### Install Dependencies
+
+```bash
+npm install
+```
+
+### Build
+
+```bash
+npm run build
+```
+
+### Running in Development Mode
+
+```bash
+npm run dev
+```
+
+### Testing
+
+```bash
+# Run manual tests (hits real Google Flights)
+npm run test:manual
+```
+
+## Project Structure
+
+```
+google-flights/
+├── local/                 # Local server implementation
+│   ├── src/
+│   │   └── index.ts      # Main entry point
+│   └── package.json
+├── shared/               # Shared business logic
+│   ├── src/
+│   │   ├── server.ts     # Server factory with DI
+│   │   ├── tools.ts      # Tool registration
+│   │   ├── tools/        # Individual tool implementations
+│   │   ├── resources.ts  # Resource implementations
+│   │   ├── flights-client/ # Google Flights client (protobuf + HTTP)
+│   │   └── logging.ts
+│   └── package.json
+├── tests/                # Test suite
+│   └── manual/           # Manual tests against real Google Flights
+└── package.json          # Root workspace config
+```
+
+## License
+
+MIT

package/build/index.js

@@ -0,0 +1,31 @@
+#!/usr/bin/env node
+import { readFileSync } from 'fs';
+import { dirname, join } from 'path';
+import { fileURLToPath } from 'url';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { createMCPServer } from '../shared/index.js';
+import { logServerStart, logError } from '../shared/logging.js';
+// Read version from package.json
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const packageJsonPath = join(__dirname, '..', 'package.json');
+const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+const VERSION = packageJson.version;
+// =============================================================================
+// MAIN ENTRY POINT
+// =============================================================================
+async function main() {
+    // No required environment variables — Google Flights uses public HTTP endpoints.
+    // No health checks needed — the first search will validate connectivity.
+    // Create server using factory
+    const { server, registerHandlers } = createMCPServer({ version: VERSION });
+    // Register all handlers (resources and tools)
+    await registerHandlers(server);
+    // Start server with stdio transport
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    logServerStart('google-flights-mcp-server');
+}
+main().catch((error) => {
+    logError('main', error);
+    process.exit(1);
+});

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "google-flights-mcp-server",
+  "version": "0.1.1",
+  "description": "MCP server for searching Google Flights — flight search, date grid pricing, and airport lookup",
+  "main": "build/index.js",
+  "type": "module",
+  "bin": {
+    "google-flights-mcp-server": "./build/index.js"
+  },
+  "files": [
+    "build/**/*.js",
+    "build/**/*.d.ts",
+    "shared/**/*.js",
+    "shared/**/*.d.ts",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "start": "node build/index.js",
+    "dev": "tsx src/index.ts",
+    "predev": "cd ../shared && npm run build && cd ../local && node setup-dev.js",
+    "prebuild": "cd ../shared && npm run build && cd ../local && node setup-dev.js",
+    "prepublishOnly": "node prepare-publish.js && node ../scripts/prepare-npm-readme.js",
+    "lint": "eslint . --ext .ts,.tsx",
+    "lint:fix": "eslint . --ext .ts,.tsx --fix",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "stage-publish": "npm version"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.19.1",
+    "protobufjs": "^7.4.0",
+    "zod": "^3.24.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.6",
+    "tsx": "^4.19.4",
+    "typescript": "^5.7.3"
+  },
+  "keywords": [
+    "mcp",
+    "google-flights",
+    "flights",
+    "flight-search",
+    "model-context-protocol"
+  ],
+  "author": "PulseMCP",
+  "license": "MIT"
+}

package/shared/flights-client/flights-client.d.ts

@@ -0,0 +1,23 @@
+import type { FlightOffer, DateGridResult, SearchFlightsOptions, SearchFlightsResult, GetDateGridOptions, AirportResult, SeatClass, TripType } from './types.js';
+export declare function buildTfsParam(options: {
+    origin: string;
+    destination: string;
+    departureDate: string;
+    returnDate?: string;
+    tripType: TripType;
+    seatClass: SeatClass;
+    adults: number;
+    children: number;
+    infantsInSeat: number;
+    infantsOnLap: number;
+    maxStops?: number;
+}): Promise<string>;
+declare function extractDs1(html: string): any | null;
+declare function formatTime(timeArr: number[] | null | undefined): string;
+declare function formatDate(dateArr: number[] | null | undefined): string;
+declare function parseFlightOffers(ds1: any, currency: string): FlightOffer[];
+export declare function searchFlights(options: SearchFlightsOptions): Promise<SearchFlightsResult>;
+export declare function getDateGrid(options: GetDateGridOptions): Promise<DateGridResult>;
+export declare function findAirportCode(query: string): Promise<AirportResult[]>;
+export { extractDs1, parseFlightOffers, formatTime, formatDate };
+//# sourceMappingURL=flights-client.d.ts.map