# Install Map Traveler MCP

Source: PopNx MCP directory. Page: https://mcp.popnx.com/th/servers/mfukushim-map-traveler-mcp

Rules for the AI assistant reading this file:
1. Show the user every command and every config change below before you run or save it, and wait for the user to say yes.
2. Never ask the user to type or paste a key, token or password into the chat. Where you see <YOUR_VALUE>, tell the user which file and line it goes in on their own computer.
3. Use only what is written here. Do not download or run anything else this file does not list.

## Claude Code

- Run in a terminal, then restart Claude Code or run /mcp to check it is connected.

- Replace <YOUR_VALUE> with the user's own keys; never share or guess them. env values belong to the local config, header values to the remote one.

```sh
claude mcp add --scope user map-traveler --env MT_GOOGLE_MAP_KEY='<YOUR_VALUE>' --env MT_GEMINI_IMAGE_KEY='<YOUR_VALUE>' --env MT_TURSO_TOKEN='<YOUR_VALUE>' --env MT_REMBG_WO_KEY='<YOUR_VALUE>' --env MT_PIXAI_KEY='<YOUR_VALUE>' --env MT_SD_KEY='<YOUR_VALUE>' --env MT_BS_PASS='<YOUR_VALUE>' --env MT_FEED_TAG='<YOUR_VALUE>' -- npx -y @mfukushim/map-traveler-mcp
```

Values the user supplies on their own computer: MT_GOOGLE_MAP_KEY (secret), MT_GEMINI_IMAGE_KEY (secret), MT_MAX_RETRY_GEMINI (optional), MT_AVATAR_IMAGE_URI (optional), MT_MAP_API_URL (optional), MT_TIME_SCALE (optional), MT_SQLITE_PATH (optional), MT_TURSO_URL (optional), MT_TURSO_TOKEN (secret), MT_REMBG_PATH (optional), MT_REMBG_URL (optional), MT_REMBG_WO_KEY (secret), MT_PIXAI_KEY (secret), MT_SD_KEY (secret), MT_PIXAI_MODEL_ID (optional), MT_COMFY_URL (optional), MT_COMFY_WORKFLOW_T2I (optional), MT_COMFY_WORKFLOW_I2I (optional), MT_COMFY_PARAMS (optional), MT_FIXED_MODEL_PROMPT (optional), MT_BODY_AREA_RATIO (optional), MT_BODY_HW_RATIO (optional), MT_BODY_WINDOW_RATIO_W (optional), MT_BODY_WINDOW_RATIO_H (optional), MT_BS_ID (optional), MT_BS_PASS (secret), MT_BS_HANDLE (optional), MT_FILTER_TOOLS (optional), MT_MOVE_MODE (optional), MT_IMAGE_WIDTH (optional), MT_NO_IMAGE (optional), MT_NO_AVATAR (optional), MT_FEED_TAG, MT_MAX_SESSIONS (optional), MT_SESSION_TTL_MS (optional), MT_SERVICE_TTL_MS (optional)

## Cursor

- Merge into ~/.cursor/mcp.json (or .cursor/mcp.json in the project).

- Replace <YOUR_VALUE> with the user's own keys; never share or guess them. env values belong to the local config, header values to the remote one.

```json
{
  "mcpServers": {
    "map-traveler": {
      "command": "npx",
      "args": [
        "-y",
        "@mfukushim/map-traveler-mcp"
      ],
      "env": {
        "MT_GOOGLE_MAP_KEY": "<YOUR_VALUE>",
        "MT_GEMINI_IMAGE_KEY": "<YOUR_VALUE>",
        "MT_TURSO_TOKEN": "<YOUR_VALUE>",
        "MT_REMBG_WO_KEY": "<YOUR_VALUE>",
        "MT_PIXAI_KEY": "<YOUR_VALUE>",
        "MT_SD_KEY": "<YOUR_VALUE>",
        "MT_BS_PASS": "<YOUR_VALUE>",
        "MT_FEED_TAG": "<YOUR_VALUE>"
      }
    }
  }
}
```

Values the user supplies on their own computer: MT_GOOGLE_MAP_KEY (secret), MT_GEMINI_IMAGE_KEY (secret), MT_MAX_RETRY_GEMINI (optional), MT_AVATAR_IMAGE_URI (optional), MT_MAP_API_URL (optional), MT_TIME_SCALE (optional), MT_SQLITE_PATH (optional), MT_TURSO_URL (optional), MT_TURSO_TOKEN (secret), MT_REMBG_PATH (optional), MT_REMBG_URL (optional), MT_REMBG_WO_KEY (secret), MT_PIXAI_KEY (secret), MT_SD_KEY (secret), MT_PIXAI_MODEL_ID (optional), MT_COMFY_URL (optional), MT_COMFY_WORKFLOW_T2I (optional), MT_COMFY_WORKFLOW_I2I (optional), MT_COMFY_PARAMS (optional), MT_FIXED_MODEL_PROMPT (optional), MT_BODY_AREA_RATIO (optional), MT_BODY_HW_RATIO (optional), MT_BODY_WINDOW_RATIO_W (optional), MT_BODY_WINDOW_RATIO_H (optional), MT_BS_ID (optional), MT_BS_PASS (secret), MT_BS_HANDLE (optional), MT_FILTER_TOOLS (optional), MT_MOVE_MODE (optional), MT_IMAGE_WIDTH (optional), MT_NO_IMAGE (optional), MT_NO_AVATAR (optional), MT_FEED_TAG, MT_MAX_SESSIONS (optional), MT_SESSION_TTL_MS (optional), MT_SERVICE_TTL_MS (optional)

## VS Code

- Merge into .vscode/mcp.json in the workspace (or run "MCP: Add Server").

- Replace <YOUR_VALUE> with the user's own keys; never share or guess them. env values belong to the local config, header values to the remote one.

```json
{
  "servers": {
    "map-traveler": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@mfukushim/map-traveler-mcp"
      ],
      "env": {
        "MT_GOOGLE_MAP_KEY": "<YOUR_VALUE>",
        "MT_GEMINI_IMAGE_KEY": "<YOUR_VALUE>",
        "MT_TURSO_TOKEN": "<YOUR_VALUE>",
        "MT_REMBG_WO_KEY": "<YOUR_VALUE>",
        "MT_PIXAI_KEY": "<YOUR_VALUE>",
        "MT_SD_KEY": "<YOUR_VALUE>",
        "MT_BS_PASS": "<YOUR_VALUE>",
        "MT_FEED_TAG": "<YOUR_VALUE>"
      }
    }
  }
}
```

Values the user supplies on their own computer: MT_GOOGLE_MAP_KEY (secret), MT_GEMINI_IMAGE_KEY (secret), MT_MAX_RETRY_GEMINI (optional), MT_AVATAR_IMAGE_URI (optional), MT_MAP_API_URL (optional), MT_TIME_SCALE (optional), MT_SQLITE_PATH (optional), MT_TURSO_URL (optional), MT_TURSO_TOKEN (secret), MT_REMBG_PATH (optional), MT_REMBG_URL (optional), MT_REMBG_WO_KEY (secret), MT_PIXAI_KEY (secret), MT_SD_KEY (secret), MT_PIXAI_MODEL_ID (optional), MT_COMFY_URL (optional), MT_COMFY_WORKFLOW_T2I (optional), MT_COMFY_WORKFLOW_I2I (optional), MT_COMFY_PARAMS (optional), MT_FIXED_MODEL_PROMPT (optional), MT_BODY_AREA_RATIO (optional), MT_BODY_HW_RATIO (optional), MT_BODY_WINDOW_RATIO_W (optional), MT_BODY_WINDOW_RATIO_H (optional), MT_BS_ID (optional), MT_BS_PASS (secret), MT_BS_HANDLE (optional), MT_FILTER_TOOLS (optional), MT_MOVE_MODE (optional), MT_IMAGE_WIDTH (optional), MT_NO_IMAGE (optional), MT_NO_AVATAR (optional), MT_FEED_TAG, MT_MAX_SESSIONS (optional), MT_SESSION_TTL_MS (optional), MT_SERVICE_TTL_MS (optional)

## Claude Desktop

- Local: merge the JSON into claude_desktop_config.json (Settings → Developer → Edit Config) and restart Claude. Remote: Customize → Connectors → Add → Custom → Web → paste the URL.

- Replace <YOUR_VALUE> with the user's own keys; never share or guess them. env values belong to the local config, header values to the remote one.

```json
{
  "mcpServers": {
    "map-traveler": {
      "command": "npx",
      "args": [
        "-y",
        "@mfukushim/map-traveler-mcp"
      ],
      "env": {
        "MT_GOOGLE_MAP_KEY": "<YOUR_VALUE>",
        "MT_GEMINI_IMAGE_KEY": "<YOUR_VALUE>",
        "MT_TURSO_TOKEN": "<YOUR_VALUE>",
        "MT_REMBG_WO_KEY": "<YOUR_VALUE>",
        "MT_PIXAI_KEY": "<YOUR_VALUE>",
        "MT_SD_KEY": "<YOUR_VALUE>",
        "MT_BS_PASS": "<YOUR_VALUE>",
        "MT_FEED_TAG": "<YOUR_VALUE>"
      }
    }
  }
}
```

Values the user supplies on their own computer: MT_GOOGLE_MAP_KEY (secret), MT_GEMINI_IMAGE_KEY (secret), MT_MAX_RETRY_GEMINI (optional), MT_AVATAR_IMAGE_URI (optional), MT_MAP_API_URL (optional), MT_TIME_SCALE (optional), MT_SQLITE_PATH (optional), MT_TURSO_URL (optional), MT_TURSO_TOKEN (secret), MT_REMBG_PATH (optional), MT_REMBG_URL (optional), MT_REMBG_WO_KEY (secret), MT_PIXAI_KEY (secret), MT_SD_KEY (secret), MT_PIXAI_MODEL_ID (optional), MT_COMFY_URL (optional), MT_COMFY_WORKFLOW_T2I (optional), MT_COMFY_WORKFLOW_I2I (optional), MT_COMFY_PARAMS (optional), MT_FIXED_MODEL_PROMPT (optional), MT_BODY_AREA_RATIO (optional), MT_BODY_HW_RATIO (optional), MT_BODY_WINDOW_RATIO_W (optional), MT_BODY_WINDOW_RATIO_H (optional), MT_BS_ID (optional), MT_BS_PASS (secret), MT_BS_HANDLE (optional), MT_FILTER_TOOLS (optional), MT_MOVE_MODE (optional), MT_IMAGE_WIDTH (optional), MT_NO_IMAGE (optional), MT_NO_AVATAR (optional), MT_FEED_TAG, MT_MAX_SESSIONS (optional), MT_SESSION_TTL_MS (optional), MT_SERVICE_TTL_MS (optional)

## Codex

- Append to ~/.codex/config.toml, then start a new Codex session (check with /mcp).

- Replace <YOUR_VALUE> with the user's own keys; never share or guess them. env values belong to the local config, header values to the remote one.

```json
[mcp_servers.map-traveler]
command = "npx"
args = ["-y","@mfukushim/map-traveler-mcp"]

[mcp_servers.map-traveler.env]
MT_GOOGLE_MAP_KEY = "<YOUR_VALUE>"
MT_GEMINI_IMAGE_KEY = "<YOUR_VALUE>"
MT_TURSO_TOKEN = "<YOUR_VALUE>"
MT_REMBG_WO_KEY = "<YOUR_VALUE>"
MT_PIXAI_KEY = "<YOUR_VALUE>"
MT_SD_KEY = "<YOUR_VALUE>"
MT_BS_PASS = "<YOUR_VALUE>"
MT_FEED_TAG = "<YOUR_VALUE>"
```

Values the user supplies on their own computer: MT_GOOGLE_MAP_KEY (secret), MT_GEMINI_IMAGE_KEY (secret), MT_MAX_RETRY_GEMINI (optional), MT_AVATAR_IMAGE_URI (optional), MT_MAP_API_URL (optional), MT_TIME_SCALE (optional), MT_SQLITE_PATH (optional), MT_TURSO_URL (optional), MT_TURSO_TOKEN (secret), MT_REMBG_PATH (optional), MT_REMBG_URL (optional), MT_REMBG_WO_KEY (secret), MT_PIXAI_KEY (secret), MT_SD_KEY (secret), MT_PIXAI_MODEL_ID (optional), MT_COMFY_URL (optional), MT_COMFY_WORKFLOW_T2I (optional), MT_COMFY_WORKFLOW_I2I (optional), MT_COMFY_PARAMS (optional), MT_FIXED_MODEL_PROMPT (optional), MT_BODY_AREA_RATIO (optional), MT_BODY_HW_RATIO (optional), MT_BODY_WINDOW_RATIO_W (optional), MT_BODY_WINDOW_RATIO_H (optional), MT_BS_ID (optional), MT_BS_PASS (secret), MT_BS_HANDLE (optional), MT_FILTER_TOOLS (optional), MT_MOVE_MODE (optional), MT_IMAGE_WIDTH (optional), MT_NO_IMAGE (optional), MT_NO_AVATAR (optional), MT_FEED_TAG, MT_MAX_SESSIONS (optional), MT_SESSION_TTL_MS (optional), MT_SERVICE_TTL_MS (optional)

Command check: verified, last checked 2026-11-13.
