tmap_mcp

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๋ฅผ ์‚ฌ์šฉํ•˜๋ ค๋ฉด ๋‹ค์Œ ๋‹จ๊ณ„๋ฅผ ๋”ฐ๋ฅด์„ธ์š”:

  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 ํด๋ž˜์Šค

์ฐธ๊ณ  ์ž๋ฃŒ