places-mcp

brukhabtu/places-mcp

3.2

If you are the rightful owner of places-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

A simple MCP server providing access to the Google Places API using FastMCP's OpenAPI integration.

The Google Places MCP Server is a streamlined implementation that utilizes FastMCP 2.0's `from_openapi` feature to create an MCP server from Google's official OpenAPI specification. This server exposes all Google Places API endpoints as MCP tools, allowing Language Model Models (LLMs) to interact with them seamlessly. With minimal code, the server automates the generation of tools for various Google Places functionalities, such as retrieving place details, conducting text and nearby searches, and more. The server is designed to simplify the integration process by handling parameter validation, request formatting, and authentication, making it an efficient solution for developers looking to leverage Google Places API capabilities within their applications.

Features

  • Automatic generation of MCP tools for all Google Places API endpoints.
  • Simplified integration with LLMs through FastMCP's `from_openapi` feature.
  • Handles parameter validation and request formatting automatically.
  • Manages authentication via the HTTP client.
  • Minimal implementation with only 30 lines of code.

Usages

usage with local integration stdio

python
mcp.run(transport='stdio')  # Tools defined via @mcp.tool() decorator

usage with remote integration sse

python
mcp.run(transport='sse', host="0.0.0.0", port=8000)  # Specify SSE endpoint

usage with remote integration streamable http

yaml
paths:
  /mcp:
    post:
      x-ms-agentic-protocol: mcp-streamable-1.0  # Copilot Studio integration

usage with platform ecosystem integration github

{"command": "docker", "args": ["run", "-e", "GITHUB_PERSONAL_ACCESS_TOKEN", "ghcr.io/github/github-mcp-server"]}

usage with development frameworks fastmcp

python
from mcp.server import FastMCP
app = FastMCP('demo')
@app.tool()
async def query(): ...

Tools

  1. placeDetails

    Get detailed information about a specific place.

  2. textSearch

    Search for places using a text query.

  3. nearbySearch

    Search for places near a specific location.

  4. findPlaceFromText

    Find a specific place from a text input.

  5. autocomplete

    Get place predictions as users type.

  6. queryAutocomplete

    Get query predictions for place searches.

  7. placePhoto

    Retrieve photos for places.