bm1120/tmap_mcp
3.1
If you are the rightful owner of tmap_mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
Tmap REST API 기반 MCP(Model Context Protocol) 서버 구축
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를 사용하려면 다음 단계를 따르세요:
- 설정 스크립트 실행:
run_setup_cursor.bat
-
Cursor 편집기를 재시작합니다.
-
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 클래스
