Google Maps Project Knowledge

Name: Google Maps Project Knowledge
Author: cablate

By cablate· cablate/mcp-google-map· 0

Learn the architecture and design decisions for the Google Maps MCP server project.

Installation

1
Make sure Claude is on your device and in your terminal.
Skills load from ~/.claude/skills/ when Claude Code starts up — so you need it on your machine first. If you don't have it yet, install it once with the command below, then run claude in any terminal to verify.
One-time setup
```
npm i -g @anthropic-ai/claude-code
```
Already have it? Skip ahead.

Paste into Claude Code or into your terminal.

Install

git clone ht••••••••••••••••••••••••••••••••••••••••••• •••••••••••••••••••••••••••• •• ••••• •• ••••••••••••••••••••••••••••••••••••••••••••••• •• •• •• •••••••••••••••••••••••••••••••••••••••••••••••••• ••••••••••••••••••••••••••••••••••••••••••••••••

This copies the whole skill folder into ~/.claude/skills/mcp-google-map-project-cablate/ — the SKILL.md plus any scripts, reference docs, or templates the skill ships with. Safe default: works for every skill.

Faster alternative (instruction-only skills)

Skips the clone and grabs only the SKILL.md file. Don't use this if the skill ships Python scripts, reference markdowns, or asset templates — they won't be downloaded and the skill will fail when it tries to load them.

Quick install (SKILL.md only)

mkdir -p ~/.•••••••••••••••••••••••••••••••••••••••••••• •• •••• ••••• •••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••• •• ••••••••••••••••••••••••••••••••••••••••••••••••••••••••

Restart Claude Code.
Quit and reopen Claude Code (or any other agent that loads from ~/.claude/skills/). New skills are picked up on startup.
Just ask Claude.
Skills auto-activate when your request matches the skill's description — no slash command needed. Trigger phrases live in the skill's own frontmatter; you can read them in the “What this skill does” section above.

Prefer to read the source first? Open on GitHub.

When Claude uses it

Project knowledge for developing and maintaining @cablate/mcp-google-map. Architecture, Google Maps API guide, GIS domain knowledge, and design decisions. Read this skill to onboard onto the project or make informed development decisions.

What this skill does

mcp-google-map — Project Knowledge

Overview

This skill contains everything needed to develop, maintain, and extend the @cablate/mcp-google-map MCP server. Reading these files gives you full context on architecture, API specifics, domain knowledge, and the reasoning behind design decisions.

For the agent skill (how to USE the tools), see skills/google-maps/SKILL.md.

Quick Orientation

Aspect	Summary
What	MCP server providing Google Maps tools for AI agents
Stack	TypeScript, Node.js, Express, MCP SDK, Zod
Tools	17 tools (14 atomic + 3 composite)
Transports	stdio, Streamable HTTP, standalone exec CLI
APIs	Places API (New), Directions, Geocoding, Elevation, Timezone, Weather, Air Quality, Static Maps, Search Along Route

Reference Files

File	Content	When to read
`references/architecture.md`	System architecture, 3-layer design, transport modes, tool registration flow, 9-file checklist, code map	Start here when onboarding. Also read when adding new tools.
`references/google-maps-api-guide.md`	All Google Maps API endpoints used, pricing, coverage limits, rate limits, common gotchas, Places New vs Legacy	When debugging API errors, evaluating new APIs, or checking costs
`references/geo-domain-knowledge.md`	GIS fundamentals — coordinates, distance, geocoding, place types, spatial search, map projection, Japan-specific knowledge	When making tool design decisions that involve geographic concepts
`references/decisions.md`	10 Architecture Decision Records (ADR) with context and rationale	When asking "why was X built this way?" or considering changes to existing design

How to Add a New Tool

See references/architecture.md § "9-File Tool Change Checklist" for the complete procedure. Summary:

Create src/tools/maps/<toolName>.ts (NAME, DESCRIPTION, SCHEMA, ACTION)
Register in src/config.ts
Add exec case in src/cli.ts
Add to tests/smoke.test.ts (expectedTools + API call test)
Update README.md (count + table + exec list + project structure)
Update skills/google-maps/SKILL.md (Tool Map)
Update skills/google-maps/references/tools-api.md (params + chaining)
Check server.json and package.json descriptions

When to Update This Skill

Trigger	What to update
Architecture change	`references/architecture.md`
New Google Maps API integrated	`references/google-maps-api-guide.md`
New design decision made	`references/decisions.md` (add ADR)
New GIS concept relevant to tools	`references/geo-domain-knowledge.md`

Related skills

Generative Code Art

anthropics

Create algorithmic art with p5.js using randomness and interactive parameters.

OfficialComplete terms in LICENSE.txt

Poster & Visual Design

anthropics

Create original posters and visual art in PNG and PDF formats.

OfficialComplete terms in LICENSE.txt

Claude API Helper

anthropics

Build, debug, and optimize Claude API applications with caching and model migration support.

OfficialComplete terms in LICENSE.txt

MCP Server Builder

anthropics

Build protocol servers that connect language models to external APIs and services.

OfficialComplete terms in LICENSE.txt