K-Targo Subway

Provides subway station search, timetable lookup, and real-time subway data via MCP tools.

typescript

1

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "slicequeue-k-targo-subway-mcp-server": {
      "command": "npx",
      "args": [
        "k-targo-subway-mcp-server"
      ],
      "env": {
        "GOV_API_KEY": "your_public_data_api_key_here"
      }
    }
  }
}

You can run and interact with the K-Targo Subway MCP Server to search subway stations, view train timetables, and access real-time subway information through a standards-driven MCP interface. This server exposes practical tools for querying station data and timetables while adhering to the Model Context Protocol, making it easy to plug into MCP clients and workflows.

How to use

You use this MCP server from an MCP client by calling the available tools. The server provides two primary tools you can invoke: a station search by name and a timetable lookup by station. You supply the required input fields, and you receive structured results that you can present in your application or workflow.

How to install

Prerequisites: you need Node.js and npm installed on your system. This server runs locally or via an MCP-enabled client that can spawn the server process.

Step 1: Set up the public data API key for the underlying subway information API. You will store the key in an environment variable GOV_API_KEY.

Step 2: Run the server using the recommended command. You can start it directly with npx.

Step 3: Optionally install and run via npm if you prefer a local install workflow.

Configuration and environment

This server relies on a public data API key. Ensure you provide GOV_API_KEY in your environment before starting the server.

Typical startup environment variable setup:

# macOS/Linux
export GOV_API_KEY=your_api_key_here

# Windows
set GOV_API_KEY=your_api_key_here

# Or use a .env file
echo "GOV_API_KEY=your_api_key_here" > .env

Dev and run commands

Run the MCP server directly with npx for quick testing.

npx k-targo-subway-mcp-server

MCP client usage notes

When configuring an MCP client to use this server, point the client to the local stdio server command. You can supply the GOV_API_KEY as part of the environment for the client or the server launch, depending on your setup.

Example (client config excerpt) - this demonstrates how to reference the server tool names and inputs from the client side.

Available tools

search_subway_station

Search subway stations by stationName to return station information.

get_station_timetable

Retrieve the timetable for a specific stationCode in a given direction (상행 or 하행).