mcp-tmap

mcp-tmap

0
location_services

MCP TMAP is a server connecting to the TMAP API, providing access to Public Transit and Location APIs. It requires Python 3.13 or higher, uv, and SK Open API credentials for configuration and operation.

MCP TMAP

The MCP connects to the TMAP API.

It currently supports the following APIs:

Prerequisites

Before you begin, ensure you have the following installed:

  • Python: Version 3.13 or higher
  • uv: You can find installation instructions here.
  • SK Open API: You need API credentials (app key) from the SK open API.

Configuration

  1. Create a .env file: Create a file in the project root.

  2. Add API Credentials: Edit the .env file and add your SK open API credentials.

    SK_OPEN_API_APP_KEY="YOUR_APP_KEY_HERE"

    Please verify the exact environment variable names required by checking src/mcp_tmap/tmap_client.py.

Running the MCP

  1. Sync Dependencies: Navigate to the project root directory in your terminal and run the following command. This will create a virtual environment (if one doesn't exist) and install all dependencies specified in pyproject.toml.

    uv sync

  2. Run:: You can run the MCP server using uv.

    uv run src/mcp_tmap

    For development,

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