# mfukushim-map-traveler-mcp

Directs a virtual avatar across Google Maps coordinates, produces composite Street View images, and shares updates to Bluesky.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 24
- Author: mfukushim
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/mfukushim/map-traveler-mcp
- Updated: 2026-08-03
- HTML: https://affpapa.org/en/nevibecode/mcp/mfukushim-map-traveler-mcp

## What it does

This server exposes tools for an AI agent to guide a traveler across real-world locations. The model inspects coordinates. It tracks progress along chosen routes and checks nearby facilities using Google Maps data.

Image synthesis relies on Google Street View photos combined with Gemini 2.5 Flash semantic masking. It inserts the character into the scene without separate background removal steps. By default, the generator creates anime-styled female characters to avoid misleading outputs. Built-in tools also handle reading feeds and posting updates to Bluesky.

Running the toolset locally requires `MT_GOOGLE_MAP_KEY` and `MT_GEMINI_IMAGE_KEY`. Location lookups fail without them, and external API requests consume provider usage limits.

## Requirements
- Remote server: `https://server.smithery.ai/@mfukushim/map-traveler-mcp/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http mfukushim-map-traveler-mcp https://server.smithery.ai/@mfukushim/map-traveler-mcp/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add mfukushim-map-traveler-mcp --url https://server.smithery.ai/@mfukushim/map-traveler-mcp/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mfukushim-map-traveler-mcp": {
            "url": "https://server.smithery.ai/@mfukushim/map-traveler-mcp/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mfukushim-map-traveler-mcp": {
            "type": "http",
            "url": "https://server.smithery.ai/@mfukushim/map-traveler-mcp/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http mfukushim-map-traveler-mcp https://server.smithery.ai/@mfukushim/map-traveler-mcp/mcp
```

## When to use it
- guide an avatar between destinations on Google Maps
- compose traveler visuals onto Google Street View backgrounds
- publish status updates and interact with mentions on Bluesky
- build narrative journey games using real-world map coordinates

## Example prompts
- Where is the traveler located right now, and what facilities are nearby?
- Head toward Tokyo Station and take a Street View photo.
- Post a brief travel update to Bluesky and check for recent mentions.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md