Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion GEMINI.md
Original file line number Diff line number Diff line change
Expand Up @@ -43,7 +43,7 @@ After using tools to gather information:
When setting up or debugging remote MCP servers (like Code Assist), it's critical to understand that modern implementations use **Streamable HTTP** endpoints (single-connection HTTP POST/GET streams) rather than the legacy two-connection SSE architectures. Keep the following client-specific formats in mind:
- **MCP Spec** ([Docs](https://modelcontextprotocol.io/docs/concepts/transports)): Official reference distinguishing `stdio`, `streamable-http`, and legacy `sse`.
- **Gemini CLI** ([Docs](https://geminicli.com/docs/tools/mcp-server/)): Uses `--transport http` in the CLI. In `settings.json` and `gemini-extension.json`, it uniquely requires the `httpUrl` property instead of the standard `url` and `type` fields.
- **Gemini Extensions** ([Docs](https://geminicli.com/docs/extensions/)): The recommended distribution mechanism is packaging the MCP server config alongside this very `GEMINI.md` and `SKILLS.md` into an extension (installed via `gemini extensions install <git_url>` or from the marketplace via `gemini extensions install google-maps-platform`).
- **Gemini Extensions** ([Docs](https://geminicli.com/docs/extensions/)): The recommended distribution mechanism is packaging the MCP server config alongside this very `GEMINI.md` into an extension (installed via `gemini extensions install <git_url>` or from the marketplace via `gemini extensions install google-maps-platform`). Dedicated agent skills are hosted separately at [googlemaps/agent-skills](https://github.com/googlemaps/agent-skills).
- **Android Studio** ([Docs](https://developer.android.com/studio/gemini/add-mcp-server)): Enabled via Settings > Tools > AI > MCP Servers. Expects an `httpUrl` property in its internal `mcp.json` exactly like Gemini CLI.
- **Antigravity** ([Docs](https://antigravity.google)): Use the built-in MCP Store in the agent panel, or manually configure the streamable HTTP endpoint in `mcp_config.json`.
- **Claude Code** ([Docs](https://docs.anthropic.com/en/docs/agents-and-tools/claude-code/overview)): Uses the `claude mcp add <name> http <url>` CLI command. Manual configs define the `mcpServers` object with `"type": "streamable-http"`.
Expand Down
17 changes: 13 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@ npm install -g @google/gemini-cli
```

2. Install the Google Maps Platform extension
- Option 1 - Install Code Assist as a Gemini CLI extension with a skill, the Code Assist MCP tool, and a Google Maps Platform CLI theme:
- Option 1 - Install Code Assist as a Gemini CLI extension (includes context prompt, Code Assist MCP tool, and Google Maps Platform CLI theme):
```bash
gemini extensions install https://github.com/googlemaps/platform-ai.git
```
Expand All @@ -39,13 +39,22 @@ npm install -g @google/gemini-cli
```json
{
"mcpServers": {
"gmp-code-assist": {
"httpUrl": "https://mapscodeassist.googleapis.com/mcp"
}
"gmp-code-assist": {
"httpUrl": "https://mapscodeassist.googleapis.com/mcp"
}
}
}
```

## **Google Maps Platform Agent Skills**

To equip your AI agents with specialized, portable Google Maps Platform workflows and best practices, check out the official [Google Maps Platform Agent Skills repository](https://github.com/googlemaps/agent-skills).

Install the agent skills in Gemini CLI:
```bash
gemini skills install https://github.com/googlemaps/agent-skills.git
```

## Install the Google Maps Platform Code Assist toolkit for other MCP clients.

For information about installing and using the toolkit with any MCP client, as well as terms of use, see the [Code Assist toolkit README](packages/code-assist/README.md).
Expand Down
3 changes: 0 additions & 3 deletions gemini-extension.json
Original file line number Diff line number Diff line change
Expand Up @@ -3,9 +3,6 @@
"version": "0.1.0",
"description": "Ground agents on fresh, official Google Maps Platform documentation and code samples for optimal geo-related developer guidance and code",
"contextFileName": "GEMINI.md",
"skills": {
"gmp-code-assist": "packages/code-assist/skills/gmp-code-assist"
},
"mcpServers": {
"gmp-code-assist": {
"httpUrl": "https://mapscodeassist.googleapis.com/mcp"
Expand Down
9 changes: 7 additions & 2 deletions packages/code-assist/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -80,11 +80,16 @@ The Code Assist MCP server is securely hosted by Google. No authentication is re
Add the remote server URL to your preferred AI client's MCP configuration file or settings UI. Find your client below for specific, verified instructions.

1. **Gemini CLI**
- Option 1 (Recommended) - Install the Code Assist MCP server as a Gemini CLI extension. This provides the most complete experience, including specialized developer skills:
- Option 1 (Recommended) - Install the Code Assist MCP server as a Gemini CLI extension (includes context prompt, Code Assist MCP tool, and Google Maps Platform theme):
```bash
gemini extensions install https://github.com/googlemaps/platform-ai.git
```
_(Alternatively, you can install it directly from the Extension Marketplace using `gemini extensions install google-maps-platform`)_
_(Alternatively, you can install it directly from the Extension Marketplace using `gemini extensions install google-maps-platform`.)_

To also install Google Maps Platform Agent Skills, see [googlemaps/agent-skills](https://github.com/googlemaps/agent-skills):
```bash
gemini skills install https://github.com/googlemaps/agent-skills.git
```
- Option 2 - Use the `mcp add` CLI command to add the server cleanly:
```bash
gemini mcp add --transport http gmp-code-assist https://mapscodeassist.googleapis.com/mcp
Expand Down
29 changes: 0 additions & 29 deletions packages/code-assist/skills/gmp-code-assist/skill.md

This file was deleted.

Loading