Mcp Tmap

What is Mcp Tmap?

Mcp Tmap is an MCP server that connects to the SK TMAP API, providing access to the Public Transit API for transit route information and the Location API for full-text geocoding. It is intended for developers using MCP-compatible clients who need to integrate TMAP transit and location services.

How to use Mcp Tmap?

Ensure Python 3.13+ and uv are installed, and obtain SK Open API credentials. Create a .env file in the project root with SK_OPEN_API_APP_KEY="YOUR_APP_KEY_HERE". Run uv sync to install dependencies, then uv run src/mcp_tmap to start the server. For development, activate the virtual environment and use mcp dev src/mcp_tmap/server.py.

Key features of Mcp Tmap

• Connects MCP to TMAP Public Transit and Location APIs
• Provides transit route planning and full-text geocoding
• Requires SK Open API app key for authentication
• Configured via .env file with SK_OPEN_API_APP_KEY
• Runs using uv sync and uv run commands
• Built for Python 3.13 and above

Use cases of Mcp Tmap

• Retrieve public transit routes between two locations using TMAP data
• Convert place names or addresses to geographic coordinates via full-text geocoding
• Integrate TMAP transit and location services into AI assistants or automation tools

FAQ from Mcp Tmap

What API does Mcp Tmap connect to?

It connects to the SK TMAP API, specifically the Public Transit API (transit route) and Location API (full-text geocoding).

What are the prerequisites to run Mcp Tmap?

You need Python 3.13 or higher, the uv package manager installed, and SK Open API credentials (app key).

How do I configure Mcp Tmap?

Create a .env file in the project root and add your SK Open API app key as SK_OPEN_API_APP_KEY="YOUR_APP_KEY_HERE".

How do I run Mcp Tmap?

Navigate to the project root, run uv sync to install dependencies, then run uv run src/mcp_tmap. For development, activate the virtual environment and use mcp dev src/mcp_tmap/server.py.