Restaurant Discovery MCP Server

A Model Context Protocol (MCP) server for restaurant discovery using Google Places API (New). Works with Claude Desktop, Cursor, AWS Strands, and any MCP-compatible client.

Tools

| Tool | Description | |------|-------------| | search_restaurants | Discover restaurants by free-text query with optional filters (open now, rating, price level) | | get_restaurant_details | Get full details (phone, website, opening hours) for a restaurant by Place ID |

Prerequisites

• Node.js >= 20
• Google Places API key with Places API (New) enabled

Usage

Claude Desktop / Cursor (npx — recommended)

No install needed. Add to your mcp.json:

{
  "mcpServers": {
    "restaurant-discovery": {
      "command": "npx",
      "args": ["-y", "restaurant-discovery-mcp"],
      "env": {
        "GOOGLE_PLACES_API_KEY": "your_key_here"
      }
    }
  }
}

Local install (alternative)

npm install -g restaurant-discovery-mcp

Then use "command": "restaurant-discovery-mcp" in your mcp.json.

Docker / Remote Agents (HTTP)

docker build -t restaurant-discovery-mcp .
docker run -p 3000:3000 -e GOOGLE_PLACES_API_KEY=your_key_here restaurant-discovery-mcp

Connect your agent to http://localhost:3000/mcp.

Configuration

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | GOOGLE_PLACES_API_KEY | Yes | — | Google Places API key | | TRANSPORT | No | stdio | stdio for local clients, http for Docker/remote | | PORT | No | 3000 | HTTP server port (HTTP mode only) | | DEFAULT_LANGUAGE | No | en | Language for API responses |

License

MIT