MCP Google Maps Scraper (Apify)

Serveur MCP (Model Context Protocol) en Python qui expose l'Actor Apify Google Maps Scraper (ID : nwua9Gu5YrADL7ZDj) sous forme d'outils utilisables par un client MCP (Claude, ChatGPT Apps, etc.).

• SDK : mcp (FastMCP inclus) + apify-client (client asynchrone)

• Transport : streamable HTTP (/mcp) — prêt pour un déploiement sur Alpic AI

• Gestion des dépendances : uv

Outils exposés

Chaque outil accepte un paramètre ctx: Context | None = None réservé à une authentification/télémétrie future.

Related MCP server: maps-scrapper

Prérequis

• Python ≥ 3.11

• uv

• Un jeton d'API Apify : https://console.apify.com/account/integrations

Installation

uv sync

Configuration

cp .env.example .env
# puis renseignez APIFY_TOKEN dans .env

Lancement en local

export APIFY_TOKEN="votre_token"
uv run python main.py

Le serveur écoute alors sur http://0.0.0.0:8000/mcp.

Tester avec l'inspecteur MCP

npx @modelcontextprotocol/inspector
# Transport : Streamable HTTP — URL : http://localhost:8000/mcp

Déploiement sur Alpic AI

1. Poussez ce dépôt sur GitHub.

2. Connectez le dépôt dans Alpic et choisissez la branche de production.

3. Renseignez la variable d'environnement APIFY_TOKEN.

4. Les commandes de build/start sont décrites dans alpic.yaml.

Alpic déploie une nouvelle version à chaque push sur la branche sélectionnée.

Structure

.
├── main.py           # Serveur MCP + outils Apify
├── pyproject.toml    # Dépendances (uv)
├── alpic.yaml        # Configuration de déploiement Alpic
├── .env.example      # Modèle de variables d'environnement
└── README.md