MCP TMAP Server

Provides access to the TMAP Public Transit and Location APIs for transit routes and geocoding.

python

0

GitHub Stars

python

Language

7 months ago

First Indexed

3 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": {
    "yunkee-lee-mcp-tmap": {
      "command": "uv",
      "args": [
        "run",
        "src/mcp_tmap"
      ],
      "env": {
        "SK_OPEN_API_APP_KEY": "YOUR_APP_KEY_HERE"
      }
    }
  }
}

The MCP TMAP server connects to the TMAP API to expose public transit routing data and full-text geocoding for location search. It lets you integrate TMAP’s transit routes and location services into your applications via MCP clients, enabling practical routing and geocoding capabilities.

How to use

You interact with the TMAP MCP server through an MCP client that communicates with the local MCP server. Start the server using the runtime command, ensuring you provide your API credentials. Once running, the server will respond to requests for transit routes and geocoding against the TMAP APIs.

Before you can use it, set your SK Open API credentials in a local environment file, then launch the MCP runtime. The server runs as a local process and expects the credentials to be available in the environment during startup.

How to install

Prerequisites you need to prepare before installing and running the MCP TMAP server.

Python 3.13 or higher
uv utility for managing MCP servers
SK Open API credentials (app key) from the SK Open API

Create a configuration file to supply your API key to the server.

SK_OPEN_API_APP_KEY="YOUR_APP_KEY_HERE"

Steps to run the server locally

Sync dependencies to prepare the runtime environment. This creates a virtual environment if needed and installs all required packages.

uv sync

Start the MCP TMAP server. This runs the MCP server against the TMAP integration.

uv run src/mcp_tmap

Development workflow

For development you can activate the virtual environment and run development tooling. This is useful when you are actively making changes to the server code.

source .venv/bin/activate
mcp dev src/mcp_tmap/server.py

Available tools

Transit route API

Provides access to real-time transit route data from the TMAP Public Transit API for routing scenarios.

Geocoding API

Provides full-text geocoding via the TMAP Location API to translate text into geographic coordinates.