tmap_mcp

What is tmap_mcp?

tmap_mcp is an MCP (Model Context Protocol) server that wraps Tmap REST APIs, allowing AI tools like Cursor editor to call Tmap API functions directly. It is implemented using the pymcp library.

How to use tmap_mcp?

Install the package with pip install pymcp requests, then set the TMAP_APP_KEY environment variable with your Tmap API key. Run the server with run_mcp_server.bat (Windows). Optionally, run run_setup_cursor.bat and restart Cursor editor, then select the 'tmap-api' server in the AI panel.

Key features of tmap_mcp

• Location search (POI keyword, address keyword, coordinate keyword)
• Geocoding and reverse geocoding
• Pedestrian route details and summary
• Car route guidance
• Real-time congestion information
• Time machine car route guidance
• Public transit route guidance and summary
• Subway train, station, and exit congestion data
• POI detail and real-time place congestion

Use cases of tmap_mcp

• Integrate Tmap location search into an AI coding assistant
• Retrieve driving or walking directions programmatically via an LLM tool
• Query real-time traffic congestion for route planning
• Obtain detailed subway congestion information for commuting apps
• Perform geocoding or reverse geocoding within AI-powered workflows

FAQ from tmap_mcp

What is required to run tmap_mcp?

Python 3.6 or higher, the pymcp and requests packages, and a valid Tmap API app key. Cursor editor is optional for AI integration.

How do I set the Tmap API key?

Set the environment variable TMAP_APP_KEY on Windows using set TMAP_APP_KEY=your_tmap_api_key, or add it as a permanent system environment variable. If not set, the server prompts for the key on startup.

What transports and authentication does tmap_mcp use?

The server uses the pymcp library (MCP over stdio/HTTP). Authentication is via the Tmap API app key, set as an environment variable.

Can I use tmap_mcp without Cursor editor?

Yes, the server runs standalone. The Cursor integration is optional.

Does tmap_mcp support real-time data?

Yes, it includes functions for real-time place congestion, subway congestion, and traffic congestion lookups.