Skip to main content
Glama
deenesjakoruzh
devsanthoshmk

Google Maps MCP Server

by devsanthoshmk
OverviewSchemaRelated ServersScoreDiscussions
Python
Hybrid

🗺️ Google Maps MCP Server (gmaps-mcp)

MCP Version Python License: MIT

자체 포함된 경량 Google Maps Model Context Protocol (MCP) 서버로, 공식 MCP Python SDK로 구축되었습니다. AI 에이전트(예: Claude Desktop, Cursor, Cline, Antigravity)에 구조화된 검색 결과, 장소 세부 정보, 평점, 연락처 정보, 좌표 및 Google Maps URL을 제공합니다.

⚡ 주요 기능

  • 원클릭 설치: 수동 환경 설정 없이 uvx를 통해 어디서나 즉시 실행됩니다.

  • 100% 자체 포함: 스크래퍼 엔진이 asyncio 및 aiohttp를 통해 기본적으로 in-process로 통합되어 외부 하위 프로세스, 헤드리스 브라우저 또는 API 키가 필요하지 않습니다.

  • 풍부한 구조화된 장소 데이터: 장소 ID, 업체명, 카테고리, 주소, 지역 및 국제 전화번호, 웹사이트 URL, 좌표(lat/long), 별점, 리뷰 수, Google Maps 직접 링크를 반환합니다.

  • Stdio 및 Streamable HTTP: 데스크톱 AI 클라이언트를 위한 네이티브 stdio 지원, 원격/컨테이너화된 배포를 위한 streamable-http 지원.

  • 깔끔한 JSON-RPC: 모든 내부 로깅은 엄격히 stderr로 파이프되어 stdio 프로토콜 스트림을 100% 준수하게 유지합니다.

Related MCP server: Google Maps MCP Server

🚀 빠른 시작

uvx를 사용하여 직접 실행:

# Run directly from GitHub repository
uvx --from git+https://github.com/<your-username>/gmaps-mcp.git gmaps-mcp

또는 로컬 클론에서:

uv run gmaps-mcp

🛠️ MCP 클라이언트 설정

1. Claude Desktop

claude_desktop_config.json에 다음을 추가하십시오 (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json, Windows: %APPDATA%\Claude\claude_desktop_config.json):

{
  "mcpServers": {
    "google-maps": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/<your-username>/gmaps-mcp.git",
        "gmaps-mcp"
      ]
    }
  }
}

로컬 폴더에서 실행하는 경우:

{
  "mcpServers": {
    "google-maps": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/absolute/path/to/gmap-mcp",
        "gmaps-mcp"
      ]
    }
  }
}

2. Cursor IDE

Cursor에서 설정 → 기능 → MCP를 열거나 (또는 프로젝트의 .cursor/mcp.json을 편집):

{
  "mcpServers": {
    "google-maps": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/<your-username>/gmaps-mcp.git",
        "gmaps-mcp"
      ]
    }
  }
}

3. Cline (VS Code Extension)

Cline 설정(cline_mcp_settings.json)에서:

{
  "mcpServers": {
    "google-maps": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/<your-username>/gmaps-mcp.git",
        "gmaps-mcp"
      ]
    }
  }
}

🧰 사용 가능한 도구

1. search_google_maps

Google Maps에서 업체, 명소, 서비스, 랜드마크를 검색합니다.

매개변수

유형

기본값

설명

query

string

(필수)

검색어 (예: "coffee in Koramangala Bangalore", "dentists near Connaught Place Delhi", "Italian restaurants in New York").

limit

integer

10

반환할 최대 결과 수 (1 ~ 50).

country

string

"in"

지역 로컬라이제이션을 위한 두 글자 ISO 국가 코드 (예: "in", "us", "gb", "de", "fr", "ae").

language

string

"en"

결과 언어 코드 (예: "en", "hi", "es", "fr").

출력 구조

{
  "query": "coffee in Koramangala Bangalore",
  "country": "in",
  "language": "en",
  "total_results": 2,
  "places": [
    {
      "place_id": "ChIJ80IECk8UrjsRqCffDjE09lw",
      "name": "Dyu Art Cafe",
      "category": "Art cafe",
      "address": "KHB MIG Colony, 1st Cross Rd, Koramangala 8th Block, Bengaluru, Karnataka 560095",
      "phone": "096113 19774",
      "international_phone": "+91 96113 19774",
      "website": "http://www.dyuartcafe.com/",
      "domain": "dyuartcafe.com",
      "latitude": 12.9373076,
      "longitude": 77.6176544,
      "rating": 4.4,
      "review_count": 21440,
      "google_maps_url": "https://www.google.com/maps/place/?q=place_id:ChIJ80IECk8UrjsRqCffDjE09lw"
    }
  ]
}

2. get_place_details

특정 장소 또는 업체의 상세 정보를 Place ID 또는 이름으로 검색합니다.

매개변수

유형

기본값

설명

place

string

(필수)

Google Place ID (예: "ChIJ12k5kG_iDDkRwuzibQwYZ4M") 또는 정확한 업체/랜드마크 이름 (예: "AIIMS New Delhi").

country

string

"in"

두 글자 ISO 국가 코드 (기본값: "in").

language

string

"en"

응답 언어 코드 (기본값: "en").

🌐 원격 배포 (Streamable HTTP)

서버는 리버스 프록시 또는 클라우드 호스팅 뒤에 배포하기 위한 최신 Streamable HTTP 전송을 지원합니다:

# Start Streamable HTTP server on port 8000
uv run gmaps-mcp --transport streamable-http --host 0.0.0.0 --port 8000

MCP 엔드포인트는 다음에서 사용 가능합니다: http://<host>:8000/mcp

🧪 개발 및 테스트

uv를 사용하여 단위 및 통합 테스트 실행:

# Run pytest test suite
uv run --with pytest --with pytest-asyncio pytest tests/ -v

# Run the server locally with debug logs
uv run gmaps-mcp --log-level DEBUG

📦 프로젝트 구조

gmap-mcp/
├── pyproject.toml              # Packaging & dependencies (PEP 517/621)
├── README.md                   # Setup guide and MCP client docs
├── src/
│   └── gmaps_mcp/
│       ├── __init__.py         # Package entry
│       ├── schemas.py          # Pydantic data models (Place, Search, Details)
│       ├── server.py           # MCPServer instance & CLI runner
│       ├── tools.py            # MCP Tool definitions & detailed descriptions
│       └── scraper/
│           ├── __init__.py     # Scraper API
│           └── crawler.py      # Async Google Maps parser & extraction engine
└── tests/
    ├── test_schemas.py         # Schema tests
    ├── test_crawler.py         # Parser unit tests
    └── test_server.py          # MCP Server registration & tool calling tests

📜 귀속 및 라이선스

  • 스크래퍼 코어는 christivn/mapScraper (커밋 1b38cf3e153294e3dad2f6cb5862be0201a54065)에서 수정 및 모듈화되었습니다.

  • MIT 라이선스에 따라 라이선스가 부여됩니다.

Install Server
A
license - permissive license
A
quality
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • Google Maps Scraper

    Live Google Maps business search, review, and photo data for AI agents over MCP.

  • bizintel

    Local business intel for AI agents: audits, lead scoring, tech stack, prospecting.

  • Parallel Search MCP

    The best web search for your AI Agent

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/devsanthoshmk/gmaps-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server