Koskamo

map-traveler-mcp

An MCP server that creates a virtual traveling bot environment using Google Maps. It allows agents to control an avatar, retrieve location and nearby facility information, generate travel images, and simulate movement to destinations via tools like get_traveler_view_info and set_traveler_location.

Package and access

Local package with source-attributed installation metadata. Koskamo does not execute packages during review.

map-traveler-mcp logo, by mfukushimCommunity listingLocal stdioSource reviewed; not executedPublished by mfukushim
Vendor documentation

What you can do with it

  • Get current avatar location and nearby facilities
  • Generate travel images using AI synthesis
  • Set avatar destination address
  • Simulate travel progress to a destination

Source and maintenance

Community listingRegistry 0.1.4
mcp-registry: io.github.mfukushim/map-traveler-mcp@0.1.4Source repository
Maintenance checked

Packages and installation

Source-provided package data. Koskamo has not executed or live-probed this package.

@mfukushim/map-traveler-mcp 0.1.4

npm
@mfukushim/map-traveler-mcp package definition
{
  "version": "0.1.4",
  "transport": "stdio",
  "identifier": "@mfukushim/map-traveler-mcp",
  "registryType": "npm",
  "registryBaseUrl": "https://registry.npmjs.org",
  "environmentVariables": [
    {
      "name": "MT_GOOGLE_MAP_KEY",
      "format": "string",
      "description": "[Map] Google Map API key"
    },
    {
      "name": "MT_GEMINI_IMAGE_KEY",
      "format": "string",
      "description": "[Image.gemini] Gemini Image Api key"
    },
    {
      "name": "MT_MAX_RETRY_GEMINI",
      "format": "string",
      "description": "[Image.gemini] Number of retries when generating Gemini images Default: 0"
    },
    {
      "name": "MT_AVATAR_IMAGE_URI",
      "format": "string",
      "description": "[Image.gemini] Character reference image uri (file:// or https://) when generating Gemini image. Multiple settings can be made by separating them with the '|'. When multiple settings are made, they will be selected randomly."
    },
    {
      "name": "MT_MAP_API_URL",
      "format": "string",
      "description": "[Map.etc] Optional: Map API custom endpoint. Example: direction=https://xxxx,places=https://yyyy "
    },
    {
      "name": "MT_TIME_SCALE",
      "format": "string",
      "description": "[Map] Optional:Scale of travel time on real roads duration. default 4"
    },
    {
      "name": "MT_SQLITE_PATH",
      "format": "string",
      "description": "[db.local] db save path: e.g. %USERPROFILE%/Desktop/traveler.sqlite ,$HOME/traveler.sqlite "
    },
    {
      "name": "MT_TURSO_URL",
      "format": "string",
      "description": "[db.api] Turso sqlite API URL"
    },
    {
      "name": "MT_TURSO_TOKEN",
      "format": "string",
      "description": "[db.api] Turso sqlite API access token"
    },
    {
      "name": "MT_REMBG_PATH",
      "format": "string",
      "description": "[rembg.local] absolute path of the installed rembg cli"
    },
    {
      "name": "MT_REMBG_URL",
      "format": "string",
      "description": "[rembg.api] withoutbg.com rembg API URL"
    },
    {
      "name": "MT_REMBG_WO_KEY",
      "format": "string",
      "description": "[rembg.api] withoutbg.com rembg API key"
    },
    {
      "name": "MT_PIXAI_KEY",
      "format": "string",
      "description": "[Image.pixAi] pixAi API key"
    },
    {
      "name": "MT_SD_KEY",
      "format": "string",
      "description": "[Image.sd] Stability.ai image generation API key"
    },
    {
      "name": "MT_PIXAI_MODEL_ID",
      "format": "string",
      "description": "[Image.pixAi] Optional: pixAi ModelId, if not set use default model 1648918127446573124 "
    },
    {
      "name": "MT_COMFY_URL",
      "format": "string",
      "description": "[Image.local.ComfyUi] Option: Generate image using ComfyUI API at specified URL. Example: http://192.168.1.100:8188"
    },
    {
      "name": "MT_COMFY_WORKFLOW_T2I",
      "format": "string",
      "description": "[Image.local.ComfyUi] Optional: Path to API workflow file when using text to image with ComfyUI. If not specified: assets/comfy/t2i_sample.json"
    },
    {
      "name": "MT_COMFY_WORKFLOW_I2I",
      "format": "string",
      "description": "[Image.local.ComfyUi] Optional: Path of API workflow file when image to image in ComfyUI. If not specified: assets/comfy/i2i_sample.json"
    },
    {
      "name": "MT_COMFY_PARAMS",
      "format": "string",
      "description": "[Image.local.ComfyUi] Optional: Variable values to send to the workflow via comfyUI API"
    },
    {
      "name": "MT_FIXED_MODEL_PROMPT",
      "format": "string",
      "description": "[Image] Optional: Fixed avatar generation prompt. You will no longer be able to change your avatar during conversations."
    },
    {
      "name": "MT_BODY_AREA_RATIO",
      "format": "string",
      "description": "[Image] Optional: Acceptable avatar image area ratio. default 0.042"
    },
    {
      "name": "MT_BODY_HW_RATIO",
      "format": "string",
      "description": "[Image] Optional: Acceptable avatar image aspect ratios. default 1.5~2.3"
    },
    {
      "name": "MT_BODY_WINDOW_RATIO_W",
      "format": "string",
      "description": "[Image] Optional: Avatar composite window horizontal ratio. default 0.5"
    },
    {
      "name": "MT_BODY_WINDOW_RATIO_H",
      "format": "string",
      "description": "[Image] Optional: Avatar composite window aspect ratio. default 0.75"
    },
    {
      "name": "MT_BS_ID",
      "format": "string",
      "description": "[Sns.Bs] Bluesky sns registration address"
    },
    {
      "name": "MT_BS_PASS",
      "format": "string",
      "description": "[Sns.Bs] bluesky sns password"
    },
    {
      "name": "MT_BS_HANDLE",
      "format": "string",
      "description": "[Sns.Bs] bluesky sns handle name: e.g. xxxxxxxx.bsky.social "
    },
    {
      "name": "MT_FILTER_TOOLS",
      "format": "string",
      "description": "[etc] Optional: Directly filter the tools to be used. All are available if not specified. e.g. tips,set_traveler_location"
    },
    {
      "name": "MT_MOVE_MODE",
      "format": "string",
      "description": "[etc] Option: Specify whether the movement mode is 'realtime' or 'skip'. default realtime"
    },
    {
      "name": "MT_IMAGE_WIDTH",
      "format": "string",
      "description": "[Image] Option: Output image width (pixels) Default is 512"
    },
    {
      "name": "MT_NO_IMAGE",
      "format": "string",
      "description": "[Image] Options: 'true' = do not output image, not specified = output image if possible, default is not specified"
    },
    {
      "name": "MT_NO_AVATAR",
      "format": "string",
      "description": "[Image] Option: 'true' = Output StreetView image as is without avatar superimposition. Not specified = Superimpose avatar image. Default is not specified."
    },
    {
      "name": "MT_FEED_TAG",
      "format": "string",
      "description": "[Sns] Optional: Specify the feed tag when posting to SNS (#required, 15 characters or more) Default is #geo_less_traveler"
    },
    {
      "name": "MT_MAX_SESSIONS",
      "format": "string",
      "description": "[Streamable-http] Maximum number of sessions when using Streamable-http"
    },
    {
      "name": "MT_SESSION_TTL_MS",
      "format": "string",
      "description": "[Streamable-http] Session TTL when using Streamable-http"
    },
    {
      "name": "MT_SERVICE_TTL_MS",
      "format": "string",
      "description": "[Streamable-http] Service TTL when using Streamable-http"
    }
  ]
}

Tools

Reported by the attributed source; not independently observed by Koskamo.

No tool definitions available.

Connect from your client

Each snippet configures the same source-provided package; replace placeholders before use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Cursor

Merge this local stdio configuration, replace every placeholder environment value, and restart Cursor. Koskamo has not executed this package.
Cursor configuration
{
  "mcpServers": {
    "map-traveler-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mfukushim/map-traveler-mcp@0.1.4"
      ],
      "env": {
        "MT_GOOGLE_MAP_KEY": "<YOUR_MT_GOOGLE_MAP_KEY>",
        "MT_GEMINI_IMAGE_KEY": "<YOUR_MT_GEMINI_IMAGE_KEY>",
        "MT_MAX_RETRY_GEMINI": "<YOUR_MT_MAX_RETRY_GEMINI>",
        "MT_AVATAR_IMAGE_URI": "<YOUR_MT_AVATAR_IMAGE_URI>",
        "MT_MAP_API_URL": "<YOUR_MT_MAP_API_URL>",
        "MT_TIME_SCALE": "<YOUR_MT_TIME_SCALE>",
        "MT_SQLITE_PATH": "<YOUR_MT_SQLITE_PATH>",
        "MT_TURSO_URL": "<YOUR_MT_TURSO_URL>",
        "MT_TURSO_TOKEN": "<YOUR_MT_TURSO_TOKEN>",
        "MT_REMBG_PATH": "<YOUR_MT_REMBG_PATH>",
        "MT_REMBG_URL": "<YOUR_MT_REMBG_URL>",
        "MT_REMBG_WO_KEY": "<YOUR_MT_REMBG_WO_KEY>",
        "MT_PIXAI_KEY": "<YOUR_MT_PIXAI_KEY>",
        "MT_SD_KEY": "<YOUR_MT_SD_KEY>",
        "MT_PIXAI_MODEL_ID": "<YOUR_MT_PIXAI_MODEL_ID>",
        "MT_COMFY_URL": "<YOUR_MT_COMFY_URL>",
        "MT_COMFY_WORKFLOW_T2I": "<YOUR_MT_COMFY_WORKFLOW_T2I>",
        "MT_COMFY_WORKFLOW_I2I": "<YOUR_MT_COMFY_WORKFLOW_I2I>",
        "MT_COMFY_PARAMS": "<YOUR_MT_COMFY_PARAMS>",
        "MT_FIXED_MODEL_PROMPT": "<YOUR_MT_FIXED_MODEL_PROMPT>",
        "MT_BODY_AREA_RATIO": "<YOUR_MT_BODY_AREA_RATIO>",
        "MT_BODY_HW_RATIO": "<YOUR_MT_BODY_HW_RATIO>",
        "MT_BODY_WINDOW_RATIO_W": "<YOUR_MT_BODY_WINDOW_RATIO_W>",
        "MT_BODY_WINDOW_RATIO_H": "<YOUR_MT_BODY_WINDOW_RATIO_H>",
        "MT_BS_ID": "<YOUR_MT_BS_ID>",
        "MT_BS_PASS": "<YOUR_MT_BS_PASS>",
        "MT_BS_HANDLE": "<YOUR_MT_BS_HANDLE>",
        "MT_FILTER_TOOLS": "<YOUR_MT_FILTER_TOOLS>",
        "MT_MOVE_MODE": "<YOUR_MT_MOVE_MODE>",
        "MT_IMAGE_WIDTH": "<YOUR_MT_IMAGE_WIDTH>",
        "MT_NO_IMAGE": "<YOUR_MT_NO_IMAGE>",
        "MT_NO_AVATAR": "<YOUR_MT_NO_AVATAR>",
        "MT_FEED_TAG": "<YOUR_MT_FEED_TAG>",
        "MT_MAX_SESSIONS": "<YOUR_MT_MAX_SESSIONS>",
        "MT_SESSION_TTL_MS": "<YOUR_MT_SESSION_TTL_MS>",
        "MT_SERVICE_TTL_MS": "<YOUR_MT_SERVICE_TTL_MS>"
      }
    }
  }
}

Cline

Merge this local stdio configuration, replace every placeholder environment value, and restart Cline. Koskamo has not executed this package.
Cline configuration
{
  "mcpServers": {
    "map-traveler-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mfukushim/map-traveler-mcp@0.1.4"
      ],
      "env": {
        "MT_GOOGLE_MAP_KEY": "<YOUR_MT_GOOGLE_MAP_KEY>",
        "MT_GEMINI_IMAGE_KEY": "<YOUR_MT_GEMINI_IMAGE_KEY>",
        "MT_MAX_RETRY_GEMINI": "<YOUR_MT_MAX_RETRY_GEMINI>",
        "MT_AVATAR_IMAGE_URI": "<YOUR_MT_AVATAR_IMAGE_URI>",
        "MT_MAP_API_URL": "<YOUR_MT_MAP_API_URL>",
        "MT_TIME_SCALE": "<YOUR_MT_TIME_SCALE>",
        "MT_SQLITE_PATH": "<YOUR_MT_SQLITE_PATH>",
        "MT_TURSO_URL": "<YOUR_MT_TURSO_URL>",
        "MT_TURSO_TOKEN": "<YOUR_MT_TURSO_TOKEN>",
        "MT_REMBG_PATH": "<YOUR_MT_REMBG_PATH>",
        "MT_REMBG_URL": "<YOUR_MT_REMBG_URL>",
        "MT_REMBG_WO_KEY": "<YOUR_MT_REMBG_WO_KEY>",
        "MT_PIXAI_KEY": "<YOUR_MT_PIXAI_KEY>",
        "MT_SD_KEY": "<YOUR_MT_SD_KEY>",
        "MT_PIXAI_MODEL_ID": "<YOUR_MT_PIXAI_MODEL_ID>",
        "MT_COMFY_URL": "<YOUR_MT_COMFY_URL>",
        "MT_COMFY_WORKFLOW_T2I": "<YOUR_MT_COMFY_WORKFLOW_T2I>",
        "MT_COMFY_WORKFLOW_I2I": "<YOUR_MT_COMFY_WORKFLOW_I2I>",
        "MT_COMFY_PARAMS": "<YOUR_MT_COMFY_PARAMS>",
        "MT_FIXED_MODEL_PROMPT": "<YOUR_MT_FIXED_MODEL_PROMPT>",
        "MT_BODY_AREA_RATIO": "<YOUR_MT_BODY_AREA_RATIO>",
        "MT_BODY_HW_RATIO": "<YOUR_MT_BODY_HW_RATIO>",
        "MT_BODY_WINDOW_RATIO_W": "<YOUR_MT_BODY_WINDOW_RATIO_W>",
        "MT_BODY_WINDOW_RATIO_H": "<YOUR_MT_BODY_WINDOW_RATIO_H>",
        "MT_BS_ID": "<YOUR_MT_BS_ID>",
        "MT_BS_PASS": "<YOUR_MT_BS_PASS>",
        "MT_BS_HANDLE": "<YOUR_MT_BS_HANDLE>",
        "MT_FILTER_TOOLS": "<YOUR_MT_FILTER_TOOLS>",
        "MT_MOVE_MODE": "<YOUR_MT_MOVE_MODE>",
        "MT_IMAGE_WIDTH": "<YOUR_MT_IMAGE_WIDTH>",
        "MT_NO_IMAGE": "<YOUR_MT_NO_IMAGE>",
        "MT_NO_AVATAR": "<YOUR_MT_NO_AVATAR>",
        "MT_FEED_TAG": "<YOUR_MT_FEED_TAG>",
        "MT_MAX_SESSIONS": "<YOUR_MT_MAX_SESSIONS>",
        "MT_SESSION_TTL_MS": "<YOUR_MT_SESSION_TTL_MS>",
        "MT_SERVICE_TTL_MS": "<YOUR_MT_SERVICE_TTL_MS>"
      }
    }
  }
}

VS Code

Merge this local stdio configuration, replace every placeholder environment value, and restart VS Code. Koskamo has not executed this package.
VS Code configuration
{
  "servers": {
    "map-traveler-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@mfukushim/map-traveler-mcp@0.1.4"
      ],
      "env": {
        "MT_GOOGLE_MAP_KEY": "<YOUR_MT_GOOGLE_MAP_KEY>",
        "MT_GEMINI_IMAGE_KEY": "<YOUR_MT_GEMINI_IMAGE_KEY>",
        "MT_MAX_RETRY_GEMINI": "<YOUR_MT_MAX_RETRY_GEMINI>",
        "MT_AVATAR_IMAGE_URI": "<YOUR_MT_AVATAR_IMAGE_URI>",
        "MT_MAP_API_URL": "<YOUR_MT_MAP_API_URL>",
        "MT_TIME_SCALE": "<YOUR_MT_TIME_SCALE>",
        "MT_SQLITE_PATH": "<YOUR_MT_SQLITE_PATH>",
        "MT_TURSO_URL": "<YOUR_MT_TURSO_URL>",
        "MT_TURSO_TOKEN": "<YOUR_MT_TURSO_TOKEN>",
        "MT_REMBG_PATH": "<YOUR_MT_REMBG_PATH>",
        "MT_REMBG_URL": "<YOUR_MT_REMBG_URL>",
        "MT_REMBG_WO_KEY": "<YOUR_MT_REMBG_WO_KEY>",
        "MT_PIXAI_KEY": "<YOUR_MT_PIXAI_KEY>",
        "MT_SD_KEY": "<YOUR_MT_SD_KEY>",
        "MT_PIXAI_MODEL_ID": "<YOUR_MT_PIXAI_MODEL_ID>",
        "MT_COMFY_URL": "<YOUR_MT_COMFY_URL>",
        "MT_COMFY_WORKFLOW_T2I": "<YOUR_MT_COMFY_WORKFLOW_T2I>",
        "MT_COMFY_WORKFLOW_I2I": "<YOUR_MT_COMFY_WORKFLOW_I2I>",
        "MT_COMFY_PARAMS": "<YOUR_MT_COMFY_PARAMS>",
        "MT_FIXED_MODEL_PROMPT": "<YOUR_MT_FIXED_MODEL_PROMPT>",
        "MT_BODY_AREA_RATIO": "<YOUR_MT_BODY_AREA_RATIO>",
        "MT_BODY_HW_RATIO": "<YOUR_MT_BODY_HW_RATIO>",
        "MT_BODY_WINDOW_RATIO_W": "<YOUR_MT_BODY_WINDOW_RATIO_W>",
        "MT_BODY_WINDOW_RATIO_H": "<YOUR_MT_BODY_WINDOW_RATIO_H>",
        "MT_BS_ID": "<YOUR_MT_BS_ID>",
        "MT_BS_PASS": "<YOUR_MT_BS_PASS>",
        "MT_BS_HANDLE": "<YOUR_MT_BS_HANDLE>",
        "MT_FILTER_TOOLS": "<YOUR_MT_FILTER_TOOLS>",
        "MT_MOVE_MODE": "<YOUR_MT_MOVE_MODE>",
        "MT_IMAGE_WIDTH": "<YOUR_MT_IMAGE_WIDTH>",
        "MT_NO_IMAGE": "<YOUR_MT_NO_IMAGE>",
        "MT_NO_AVATAR": "<YOUR_MT_NO_AVATAR>",
        "MT_FEED_TAG": "<YOUR_MT_FEED_TAG>",
        "MT_MAX_SESSIONS": "<YOUR_MT_MAX_SESSIONS>",
        "MT_SESSION_TTL_MS": "<YOUR_MT_SESSION_TTL_MS>",
        "MT_SERVICE_TTL_MS": "<YOUR_MT_SERVICE_TTL_MS>"
      }
    }
  }
}

Claude Desktop

Merge this local stdio configuration, replace every placeholder environment value, and restart Claude Desktop. Koskamo has not executed this package.
Claude Desktop configuration
{
  "mcpServers": {
    "map-traveler-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mfukushim/map-traveler-mcp@0.1.4"
      ],
      "env": {
        "MT_GOOGLE_MAP_KEY": "<YOUR_MT_GOOGLE_MAP_KEY>",
        "MT_GEMINI_IMAGE_KEY": "<YOUR_MT_GEMINI_IMAGE_KEY>",
        "MT_MAX_RETRY_GEMINI": "<YOUR_MT_MAX_RETRY_GEMINI>",
        "MT_AVATAR_IMAGE_URI": "<YOUR_MT_AVATAR_IMAGE_URI>",
        "MT_MAP_API_URL": "<YOUR_MT_MAP_API_URL>",
        "MT_TIME_SCALE": "<YOUR_MT_TIME_SCALE>",
        "MT_SQLITE_PATH": "<YOUR_MT_SQLITE_PATH>",
        "MT_TURSO_URL": "<YOUR_MT_TURSO_URL>",
        "MT_TURSO_TOKEN": "<YOUR_MT_TURSO_TOKEN>",
        "MT_REMBG_PATH": "<YOUR_MT_REMBG_PATH>",
        "MT_REMBG_URL": "<YOUR_MT_REMBG_URL>",
        "MT_REMBG_WO_KEY": "<YOUR_MT_REMBG_WO_KEY>",
        "MT_PIXAI_KEY": "<YOUR_MT_PIXAI_KEY>",
        "MT_SD_KEY": "<YOUR_MT_SD_KEY>",
        "MT_PIXAI_MODEL_ID": "<YOUR_MT_PIXAI_MODEL_ID>",
        "MT_COMFY_URL": "<YOUR_MT_COMFY_URL>",
        "MT_COMFY_WORKFLOW_T2I": "<YOUR_MT_COMFY_WORKFLOW_T2I>",
        "MT_COMFY_WORKFLOW_I2I": "<YOUR_MT_COMFY_WORKFLOW_I2I>",
        "MT_COMFY_PARAMS": "<YOUR_MT_COMFY_PARAMS>",
        "MT_FIXED_MODEL_PROMPT": "<YOUR_MT_FIXED_MODEL_PROMPT>",
        "MT_BODY_AREA_RATIO": "<YOUR_MT_BODY_AREA_RATIO>",
        "MT_BODY_HW_RATIO": "<YOUR_MT_BODY_HW_RATIO>",
        "MT_BODY_WINDOW_RATIO_W": "<YOUR_MT_BODY_WINDOW_RATIO_W>",
        "MT_BODY_WINDOW_RATIO_H": "<YOUR_MT_BODY_WINDOW_RATIO_H>",
        "MT_BS_ID": "<YOUR_MT_BS_ID>",
        "MT_BS_PASS": "<YOUR_MT_BS_PASS>",
        "MT_BS_HANDLE": "<YOUR_MT_BS_HANDLE>",
        "MT_FILTER_TOOLS": "<YOUR_MT_FILTER_TOOLS>",
        "MT_MOVE_MODE": "<YOUR_MT_MOVE_MODE>",
        "MT_IMAGE_WIDTH": "<YOUR_MT_IMAGE_WIDTH>",
        "MT_NO_IMAGE": "<YOUR_MT_NO_IMAGE>",
        "MT_NO_AVATAR": "<YOUR_MT_NO_AVATAR>",
        "MT_FEED_TAG": "<YOUR_MT_FEED_TAG>",
        "MT_MAX_SESSIONS": "<YOUR_MT_MAX_SESSIONS>",
        "MT_SESSION_TTL_MS": "<YOUR_MT_SESSION_TTL_MS>",
        "MT_SERVICE_TTL_MS": "<YOUR_MT_SERVICE_TTL_MS>"
      }
    }
  }
}

Let your agent find its tools

Find servers like map-traveler-mcp from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Connect Koskamo Explore workflows
See all 1,970