mcpField
T
tmap_mcp

tmap_mcp

Local
github.com/bm1120Maps & Travel1Updated 81w ago
Repository

About tmap_mcp

tmap_mcp exposes Tmap REST API capabilities to AI tools such as Cursor through MCP. It covers location lookup, geocoding, route guidance, and congestion information.

Key features

  1. 01POI and address search
  2. 02Geocoding and reverse geocoding
  3. 03Pedestrian, car, and transit routes
  4. 04Real-time place and subway congestion
  5. 05Time-machine route guidance

Use cases

  1. 01Find places or addresses by keyword
  2. 02Convert addresses and coordinates
  3. 03Get pedestrian, driving, or transit routes
  4. 04Check place and subway congestion

MCP support

It provides a Tmap REST API-based MCP server, allowing compatible AI tools to call Tmap functions through exposed tools.

#tmap#mcp#api#location-services

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

tmap_mcp

Tmap REST API 기반 MCP(Model Context Protocol) 서버 구축

개요

이 프로젝트는 T맵 REST API를 MCP(Model Context Protocol) 서버로 제공하여 Cursor 편집기와 같은 AI 도구에서 직접 T맵 API 기능을 호출할 수 있도록 합니다. pymcp 라이브러리를 사용하여 구현되었습니다.

주요 기능

  • 위치 검색 (POI 검색, 주소 검색)
  • 지오코딩 및 역지오코딩
  • 보행자 경로 안내
  • 자동차 경로 안내
  • 실시간 혼잡도 조회
  • 타임머신 경로 안내
  • 대중교통 경로 안내
  • 대중교통 경로 요약 정보
  • 기타 T맵 API 기능들

설치 및 설정

필수 요구사항
  • Python 3.6 이상
  • T맵 API 앱 키
  • Cursor 편집기 (AI 기능 사용 시)
패키지 설치
pip install pymcp requests
T맵 API 키 설정

Windows에서는 다음 명령어로 환경 변수를 설정할 수 있습니다:

set TMAP_APP_KEY=your_tmap_api_key

영구적으로 설정하려면 시스템 환경 변수에 추가하세요.

사용 방법

1. MCP 서버 실행
run_mcp_server.bat

실행 시 T맵 API 키가 환경 변수로 설정되어 있지 않으면 입력 프롬프트가 표시됩니다.

2. Cursor 편집기와 연결 (선택 사항)

Cursor 편집기에서 MCP 서버를 통해 T맵 API를 사용하려면 다음 단계를 따르세요:

  1. 설정 스크립트 실행:
run_setup_cursor.bat

  1. Cursor 편집기를 재시작합니다.

  2. Cursor 편집기의 AI 패널에서 'tmap-api' 서버를 선택합니다.

기능 설명

위치 검색
  • search_poi_keyword: 키워드로 POI(관심 지점) 검색
  • search_address_keyword: 키워드로 주소 검색
  • search_coord_keyword: 키워드로 좌표 검색
지오코딩
  • geocoding: 주소를 좌표로 변환
  • full_text_geocoding: 자유 형식 텍스트 주소를 좌표로 변환
  • reverse_geocoding: 좌표를 주소로 변환
경로 안내
  • pedestrian_route_detail: 보행자 경로 상세 정보 조회
  • pedestrian_route_summary: 보행자 경로 요약 정보 조회
  • car_route: 자동차 경로 안내
  • time_machine_route: 타임머신 자동차 경로 안내
  • public_transit_route: 대중교통 경로 안내
  • get_subway_congestion: 지하철 열차 혼잡도 조회
장소 정보
  • get_poi_detail: POI 상세 정보 검색
  • realtime_place_congestion: 실시간 장소 혼잡도 조회
지하철 정보
  • get_subway_congestion: 지하철 열차 혼잡도 조회
  • get_subway_station_congestion: 지하철 칸별 혼잡도 조회
  • get_subway_exit_ratio: 지하철 칸별 하차 비율 조회

파일 구조

  • mcp_server.py - MCP 서버 구현
  • run_mcp_server.bat - Windows에서 서버를 실행하는 배치 파일
  • setup_cursor.py - Cursor 편집기 설정 스크립트
  • run_setup_cursor.bat - 설정 스크립트 실행 배치 파일
  • tmap_api/ - T맵 API 패키지
    • tmap_api.py - T맵 API 클래스

참고 자료

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.