Map Traveler MCP

Instructions

Implementation Reference

• src/RunnerService.ts:290-296 (handler)

  Core handler logic for retrieving current view/location information, called by the tool with parameters (dayjs(), false, true, env.isPractice). Computes run status, elapsed time, and generates view details including facilities and position.

  function getCurrentView(now: dayjs.Dayjs, includePhoto: boolean, includeNearbyFacilities: boolean, practice = false) {
    return Effect.gen(function* () {
      const {runStatus, justArrive, elapseRatio} = yield* getRunStatusAndUpdateEnd(now,practice);
      //  ただし前回旅が存在し、それが終了していても、そのendTimeから1時間以内ならその場所にいるものとして表示する
      return yield* makeView(runStatus, elapseRatio, justArrive && dayjs().isBefore(dayjs.unix(runStatus.tilEndEpoch).add(1, "hour")), includePhoto, includeNearbyFacilities, practice)
    })
  }

• src/McpService.ts:1033-1034 (handler)

  Dispatch handler in toolSwitch function that routes 'get_traveler_location' tool calls to getCurrentLocationInfo(false, true, env).

  case "get_traveler_location":
    return getCurrentLocationInfo(false, true,env)

• src/McpService.ts:566-568 (helper)

  Helper wrapper function getCurrentLocationInfo that invokes RunnerService.getCurrentView with current time, specified photo and facilities flags, and practice mode.

  const getCurrentLocationInfo = (includePhoto: boolean, includeNearbyFacilities: boolean,env:Mode) => {
    return RunnerService.getCurrentView(dayjs(), includePhoto, includeNearbyFacilities, env.isPractice)
  }

• src/McpService.ts:284-293 (schema)

  Input schema definition for the 'get_traveler_location' tool in GET_VIEW_COMMAND array, used in makeToolsDef for tool listing. No input parameters required.

  {
    name: "get_traveler_location",  //  関数名の合成現象があった? とりあえずaliasを置く
    title: "Get the traveler's current location",
    description:
      "Get the address of the current traveler's location",
    inputSchema: {
      type: "object",
      properties: {}
    }
  },

• src/McpService.ts:264-295 (registration)

  Registration of 'get_traveler_location' tool within GET_VIEW_COMMAND array in makeToolsDef function, conditionally included based on environment (travelerExist). Used for listing available tools.

    {
      name: env.personMode === 'second' ? "get_current_view_info" : "get_traveler_view_info",
      title: "Get the current location's view",
      description: env.personMode === 'second' ?
        "Get the address of the current location and information on nearby facilities,view snapshot" :
        "Get the address of the current traveler's location and information on nearby facilities,view snapshot",
      inputSchema: {
        type: "object",
        properties: {
          includePhoto: {
            type: "boolean",
            description: "Get scenery photos of current location"
          },
          includeNearbyFacilities: {
            type: "boolean",
            description: "Get information on nearby facilities"
          },
        }
      }
    },
    {
      name: "get_traveler_location",  //  関数名の合成現象があった? とりあえずaliasを置く
      title: "Get the traveler's current location",
      description:
        "Get the address of the current traveler's location",
      inputSchema: {
        type: "object",
        properties: {}
      }
    },
  ]