tmap_mcp
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 ํด๋์ค