jeong-sik_kakao-api-mcp-server

jeong-sik_kakao-api-mcp-server

3.2

If you are the rightful owner of jeong-sik_kakao-api-mcp-server 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.

This server allows AI models to utilize Kakao Map's mapping features and Daum's various search functions through the Model Context Protocol (MCP).

์นด์นด์˜ค API MCP ์„œ๋ฒ„

์นด์นด์˜ค๋งต API ๋ฐ Daum ๊ฒ€์ƒ‰ API๋ฅผ Model Context Protocol(MCP)์„ ํ†ตํ•ด ํ™œ์šฉํ•  ์ˆ˜ ์žˆ๋Š” ์„œ๋ฒ„์ž…๋‹ˆ๋‹ค. ์ด ์„œ๋ฒ„๋ฅผ ํ†ตํ•ด AI ๋ชจ๋ธ์ด ์นด์นด์˜ค๋งต์˜ ์ง€๋„ ๊ด€๋ จ ๊ธฐ๋Šฅ๊ณผ Daum์˜ ๋‹ค์–‘ํ•œ ๊ฒ€์ƒ‰ ๊ธฐ๋Šฅ์„ ํ™œ์šฉํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

์ฃผ์˜ ์‚ฌํ•ญ

  • ์นด์นด์˜ค ๋กœ๊ทธ์ธ, ์นด์นด์˜คํ†ก ๋ฉ”์‹œ์ง€ ๋ณด๋‚ด๊ธฐ ๋“ฑ ์‚ฌ์šฉ์ž ๊ณ„์ • ๊ด€๋ จ ๊ธฐ๋Šฅ์€ ํฌํ•จ๋˜์–ด ์žˆ์ง€ ์•Š์Šต๋‹ˆ๋‹ค. ์ด ์„œ๋ฒ„๋Š” ๊ณต๊ฐœ๋œ ์นด์นด์˜ค ๋ฐ Daum์˜ Open API๋งŒ์„ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค.
  • ๋ณธ ์„œ๋ฒ„๋ฅผ ์‚ฌ์šฉํ•˜๊ธฐ ์œ„ํ•ด์„œ๋Š” ์œ ํšจํ•œ ์นด์นด์˜ค REST API ํ‚ค๊ฐ€ ํ•„์š”ํ•ฉ๋‹ˆ๋‹ค. ์นด์นด์˜ค ๋””๋ฒจ๋กœํผ์Šค์—์„œ ์•ฑ์„ ์ƒ์„ฑํ•˜๊ณ  REST API ํ‚ค๋ฅผ ๋ฐœ๊ธ‰๋ฐ›์œผ์„ธ์š”.

์ฃผ์š” ๊ธฐ๋Šฅ

์นด์นด์˜ค๋งต API

  1. ์žฅ์†Œ ๊ฒ€์ƒ‰ (mcp_kakao_map_search_places)

    • ํ‚ค์›Œ๋“œ๋กœ ์นด์นด์˜ค๋งต์—์„œ ์žฅ์†Œ๋ฅผ ๊ฒ€์ƒ‰
    • ์œ„์น˜, ์นดํ…Œ๊ณ ๋ฆฌ, ์—ฐ๋ฝ์ฒ˜ ์ •๋ณด ์ œ๊ณต
  2. ์ขŒํ‘œ-์ฃผ์†Œ ๋ณ€ํ™˜ (mcp_kakao_map_coord_to_address)

    • ๊ฒฝ์œ„๋„ ์ขŒํ‘œ๋ฅผ ์‹ค์ œ ์ฃผ์†Œ๋กœ ๋ณ€ํ™˜
    • ๋„๋กœ๋ช… ์ฃผ์†Œ ๋ฐ ์ง€๋ฒˆ ์ฃผ์†Œ ์ •๋ณด ์ œ๊ณต
  3. ๊ธธ์ฐพ๊ธฐ (mcp_kakao_map_find_route)

    • ์ถœ๋ฐœ์ง€์—์„œ ๋ชฉ์ ์ง€๊นŒ์ง€์˜ ๊ฒฝ๋กœ ๊ฒ€์ƒ‰
    • ๊ฑฐ๋ฆฌ, ์†Œ์š” ์‹œ๊ฐ„, ์˜ˆ์ƒ ํƒ์‹œ ์š”๊ธˆ ๋“ฑ ์ œ๊ณต
    • ๊ตํ†ต ์ƒํ™ฉ ์ •๋ณด ํฌํ•จ (์„ ํƒ์ )

Daum ๊ฒ€์ƒ‰ API

  1. ์›น ๋ฌธ์„œ ๊ฒ€์ƒ‰ (mcp_kakao_map_search_web)

    • ํ‚ค์›Œ๋“œ๋กœ ๋‹ค์Œ ์›น ๋ฌธ์„œ ๊ฒ€์ƒ‰
    • ํŽ˜์ด์ง€ ์ •๋ ฌ ๋ฐ ๊ฒ€์ƒ‰ ๊ฒฐ๊ณผ ๊ฐœ์ˆ˜ ์กฐ์ • ๊ฐ€๋Šฅ
  2. ์ด๋ฏธ์ง€ ๊ฒ€์ƒ‰ (mcp_kakao_map_search_image)

    • ํ‚ค์›Œ๋“œ๋กœ ๋‹ค์Œ ์ด๋ฏธ์ง€ ๊ฒ€์ƒ‰
    • ์ด๋ฏธ์ง€ URL ๋ฐ ๊ด€๋ จ ์ •๋ณด ์ œ๊ณต
  3. ๋ธ”๋กœ๊ทธ ๊ฒ€์ƒ‰ (mcp_kakao_map_search_blog)

    • ํ‚ค์›Œ๋“œ๋กœ ๋‹ค์Œ ๋ธ”๋กœ๊ทธ ๊ธ€ ๊ฒ€์ƒ‰
    • ๋ธ”๋กœ๊ทธ ์ด๋ฆ„, ํฌ์ŠคํŠธ ์ œ๋ชฉ, ๋‚ด์šฉ ์š”์•ฝ ์ œ๊ณต
  4. ์นดํŽ˜ ๊ฒ€์ƒ‰ (mcp_kakao_map_search_cafe)

    • ํ‚ค์›Œ๋“œ๋กœ ๋‹ค์Œ ์นดํŽ˜ ๊ธ€ ๊ฒ€์ƒ‰
    • ์นดํŽ˜ ์ด๋ฆ„, ๊ฒŒ์‹œ๋ฌผ ์ œ๋ชฉ, ๋‚ด์šฉ ์š”์•ฝ ์ œ๊ณต

๋„๊ตฌ ์‚ฌ์šฉ ์˜ˆ์‹œ (MCP)

์•„๋ž˜๋Š” MCP ํด๋ผ์ด์–ธํŠธ(์˜ˆ: AI ๋ชจ๋ธ)๊ฐ€ ์ด ์„œ๋ฒ„์˜ ๋„๊ตฌ๋ฅผ ํ˜ธ์ถœํ•˜๋Š” ๋ฐฉ๋ฒ•๊ณผ ์˜ˆ์ƒ๋˜๋Š” ์‘๋‹ต ํ˜•์‹์ž…๋‹ˆ๋‹ค.

์นด์นด์˜ค๋งต API

1. ์žฅ์†Œ ๊ฒ€์ƒ‰ (mcp_kakao_map_search_places)

ํ˜ธ์ถœ (Request):

{
  "tool_name": "mcp_kakao_map_search_places",
  "parameters": {
    "keyword": "ํŒ๊ต์—ญ ํ˜„๋Œ€๋ฐฑํ™”์ "
  }
}

์‘๋‹ต (Response - ์˜ˆ์‹œ):

{
  "tool_name": "mcp_kakao_map_search_places",
  "result": "์žฅ์†Œ ๊ฒ€์ƒ‰ ๊ฒฐ๊ณผ (๊ฒฐ๊ณผ ์ˆ˜: 15, ์ด 18๊ฐœ):\n์ด๋ฆ„: ํ˜„๋Œ€๋ฐฑํ™”์  ํŒ๊ต์ \n์ฃผ์†Œ: ๊ฒฝ๊ธฐ ์„ฑ๋‚จ์‹œ ๋ถ„๋‹น๊ตฌ ๋ฐฑํ˜„๋™ 541\n์นดํ…Œ๊ณ ๋ฆฌ: ์‡ผํ•‘,์œ ํ†ต > ๋ฐฑํ™”์  > ํ˜„๋Œ€๋ฐฑํ™”์ \n์ „ํ™”๋ฒˆํ˜ธ: 031-5170-2233\n์ƒ์„ธ์ •๋ณด: http://place.map.kakao.com/18757447\n---\n... (์ถ”๊ฐ€ ๊ฒฐ๊ณผ)"
}
2. ์ขŒํ‘œ-์ฃผ์†Œ ๋ณ€ํ™˜ (mcp_kakao_map_coord_to_address)

ํ˜ธ์ถœ (Request):

{
  "tool_name": "mcp_kakao_map_coord_to_address",
  "parameters": {
    "x": 127.1120278,
    "y": 37.3955833
  }
}

์‘๋‹ต (Response - ์˜ˆ์‹œ):

{
  "tool_name": "mcp_kakao_map_coord_to_address",
  "result": "์ฃผ์†Œ ๋ณ€ํ™˜ ๊ฒฐ๊ณผ:\n๋„๋กœ๋ช…: ๊ฒฝ๊ธฐ ์„ฑ๋‚จ์‹œ ๋ถ„๋‹น๊ตฌ ํŒ๊ต์—ญ๋กœ146๋ฒˆ๊ธธ 20\n์ง€๋ฒˆ: ๊ฒฝ๊ธฐ ์„ฑ๋‚จ์‹œ ๋ถ„๋‹น๊ตฌ ๋ฐฑํ˜„๋™ 535"
}
3. ๊ธธ์ฐพ๊ธฐ (mcp_kakao_map_find_route)

ํ˜ธ์ถœ (Request):

{
  "tool_name": "mcp_kakao_map_find_route",
  "parameters": {
    "origin": "ํŒ๊ต์—ญ",
    "destination": "์ •์ž์—ญ",
    "transportation_type": "car",
    "traffic_info": true
  }
}

์‘๋‹ต (Response - ์˜ˆ์‹œ):

{
  "tool_name": "mcp_kakao_map_find_route",
  "result": "๐Ÿ—บ๏ธ ๊ธธ์ฐพ๊ธฐ ๊ฒฐ๊ณผ\n\n์ถœ๋ฐœ์ง€: ํŒ๊ต์—ญ ์‹ ๋ถ„๋‹น์„  (๊ฒฝ๊ธฐ ์„ฑ๋‚จ์‹œ ๋ถ„๋‹น๊ตฌ ์‚ผํ‰๋™)\n\n๋ชฉ์ ์ง€: ์ •์ž์—ญ ์‹ ๋ถ„๋‹น์„  (๊ฒฝ๊ธฐ ์„ฑ๋‚จ์‹œ ๋ถ„๋‹น๊ตฌ ์ •์ž๋™)\n\n์ด๋™ ์ˆ˜๋‹จ: ์ž๋™์ฐจ\n\n์ด ๊ฑฐ๋ฆฌ: 3.6km\n์˜ˆ์ƒ ์†Œ์š” ์‹œ๊ฐ„: 10๋ถ„\n์˜ˆ์ƒ ํƒ์‹œ ์š”๊ธˆ: 5,600์›\n\n๐Ÿ“Š ๊ตํ†ต ์ƒํ™ฉ ์š”์•ฝ:\n\n์นด์นด์˜ค๋งต์—์„œ ๋ณด๊ธฐ: https://map.kakao.com/?sName=%ED%8C%90%EA%B5%90%EC%97%AD&eName=%EC%A0%95%EC%9E%90%EC%97%AD\n"
}

Daum ๊ฒ€์ƒ‰ API

1. ์›น ๋ฌธ์„œ ๊ฒ€์ƒ‰ (mcp_kakao_map_search_web)

ํ˜ธ์ถœ (Request):

{
  "tool_name": "mcp_kakao_map_search_web",
  "parameters": {
    "query": "์นด์นด์˜ค๋ธŒ๋ ˆ์ธ ์นผ๋กœ",
    "size": 2
  }
}

์‘๋‹ต (Response - ์˜ˆ์‹œ):

{
  "tool_name": "mcp_kakao_map_search_web",
  "result": "์›น ๋ฌธ์„œ ๊ฒ€์ƒ‰ ๊ฒฐ๊ณผ (์ด 2083๊ฐœ ์ค‘ 2๊ฐœ ํ‘œ์‹œ):\n\n1. ์นด์นด์˜ค๋ธŒ๋ ˆ์ธ | ์นผ๋กœ Karlo\n   ๋‚ด์šฉ: ์นด์นด์˜ค๋ธŒ๋ ˆ์ธ์˜ ์ด๋ฏธ์ง€ ์ƒ์„ฑ ๋ชจ๋ธ Karlo๋Š” ์‚ฌ์šฉ์ž๊ฐ€ ์ž…๋ ฅํ•œ ๋ฌธ์žฅ(Text)์„ ์ดํ•ดํ•˜์—ฌ, ์„ธ์ƒ์— ๋‹จ ํ•˜๋‚˜๋ฟ์ธ ์ด๋ฏธ์ง€๋ฅผ ๋งŒ๋“ค์–ด๋‚ด๋Š” ์ธ๊ณต์ง€๋Šฅ ํ™”๊ฐ€์ž…๋‹ˆ๋‹ค. ์ˆ˜๋ฐฑ๋งŒ ์žฅ ๊ทœ๋ชจ์˜...\n   URL: https://kakaobrain.com/karlo\n   ๋‚ ์งœ: 2024. 1. 1.\n\n2. ์นด์นด์˜ค๋ธŒ๋ ˆ์ธ, AI ์•„ํ‹ฐ์ŠคํŠธ '์นผ๋กœ 2.0' ๊ณต๊ฐœ - ํ…Œํฌ๋ ˆ์‹œํ”ผ\n   ๋‚ด์šฉ: ์นด์นด์˜ค๋ธŒ๋ ˆ์ธ์ด ์ดˆ๊ฑฐ๋Œ€ ์ธ๊ณต์ง€๋Šฅ(AI) ์ด๋ฏธ์ง€ ์ƒ์„ฑ ๋ชจ๋ธ '์นผ๋กœ(Karlo) 2.0'์„ ๊ณต๊ฐœํ–ˆ๋‹ค๊ณ  11์ผ ๋ฐํ˜”๋‹ค. ์นผ๋กœ 2.0์€ ์•ฝ 3์–ต ์žฅ ๊ทœ๋ชจ์˜ ํ…์ŠคํŠธ-์ด๋ฏธ์ง€ ๋ฐ์ดํ„ฐ์…‹์„ ํ•™์Šตํ•œ ๋ชจ๋ธ์ด...\n   URL: https://techrecipe.co.kr/posts/56513\n   ๋‚ ์งœ: 2023. 7. 11.\n\nํ˜„์žฌ ํŽ˜์ด์ง€๊ฐ€ ๋งˆ์ง€๋ง‰ ํŽ˜์ด์ง€๊ฐ€ ์•„๋‹™๋‹ˆ๋‹ค. ๋” ๋งŽ์€ ๊ฒฐ๊ณผ๋ฅผ ๋ณด๋ ค๋ฉด page ๋งค๊ฐœ๋ณ€์ˆ˜๋ฅผ ์ฆ๊ฐ€์‹œํ‚ค์„ธ์š”.\n"
}
2. ์ด๋ฏธ์ง€ ๊ฒ€์ƒ‰ (mcp_kakao_map_search_image)

ํ˜ธ์ถœ (Request):

{
  "tool_name": "mcp_kakao_map_search_image",
  "parameters": {
    "query": "๊ณ ์–‘์ด",
    "size": 1
  }
}

์‘๋‹ต (Response - ์˜ˆ์‹œ):

{
  "tool_name": "mcp_kakao_map_search_image",
  "result": "์ด๋ฏธ์ง€ ๊ฒ€์ƒ‰ ๊ฒฐ๊ณผ (์ด 8715385๊ฐœ ์ค‘ 1๊ฐœ ํ‘œ์‹œ):\n\n1. ์ปฌ๋ ‰์…˜ ์ด๋ฆ„: Daum ๋ฐฑ๊ณผ\n   ๋ฌธ์„œ URL: http://100.daum.net/encyclopedia/view/172XX61300001\n   ์ด๋ฏธ์ง€ URL: https://t1.daumcdn.net/thumb/R1024x0/?fname=http%3A%2F%2Ft1.daumcdn.net%2Fencyclop%2F172%2F613%2F172XX61300001\n   ์ธ๋„ค์ผ URL: https://search1.kakaocdn.net/thumb/R100x100/?fname=http%3A%2F%2Ft1.daumcdn.net%2Fencyclop%2F172%2F613%2F172XX61300001&token=1579057346066cfd0b2e0c671d07c433\n   ํฌ๊ธฐ: ๊ฐ€๋กœ 1024px, ์„ธ๋กœ 682px\n   ํ‘œ์‹œ URL: 100.daum.net\n   ๋‚ ์งœ: 2014. 11. 6.\n\nํ˜„์žฌ ํŽ˜์ด์ง€๊ฐ€ ๋งˆ์ง€๋ง‰ ํŽ˜์ด์ง€๊ฐ€ ์•„๋‹™๋‹ˆ๋‹ค. ๋” ๋งŽ์€ ๊ฒฐ๊ณผ๋ฅผ ๋ณด๋ ค๋ฉด page ๋งค๊ฐœ๋ณ€์ˆ˜๋ฅผ ์ฆ๊ฐ€์‹œํ‚ค์„ธ์š”.\n"
}
3. ๋ธ”๋กœ๊ทธ ๊ฒ€์ƒ‰ (mcp_kakao_map_search_blog)

ํ˜ธ์ถœ (Request):

{
  "tool_name": "mcp_kakao_map_search_blog",
  "parameters": {
    "query": "ํŒ๊ต ๋ง›์ง‘",
    "size": 1
  }
}

์‘๋‹ต (Response - ์˜ˆ์‹œ):

{
  "tool_name": "mcp_kakao_map_search_blog",
  "result": "๋ธ”๋กœ๊ทธ ๊ฒ€์ƒ‰ ๊ฒฐ๊ณผ (์ด 215893๊ฐœ ์ค‘ 1๊ฐœ ํ‘œ์‹œ):\n\n1. ๋ธ”๋กœ๊ทธ๋ช…: ์งฑ๋Œ์˜ ์ผ์ƒ๋‹ค๋ฐ˜์‚ฌ\n   ์ œ๋ชฉ: ํŒ๊ต ๋ง›์ง‘ ์ถ”์ฒœ | ์œ ์ŠคํŽ˜์ด์Šค๋ชฐ ๊ฐ€์„ฑ๋น„ ์ข‹์€ ์ ์‹ฌ ๋ง›์ง‘\n   ๋‚ด์šฉ: ํŒ๊ตํ…Œํฌ๋…ธ๋ฐธ๋ฆฌ ์œ ์ŠคํŽ˜์ด์Šค๋ชฐ์€ ๋Š˜ ์ ์‹ฌ์‹œ๊ฐ„๋งˆ๋‹ค ์ง์žฅ์ธ๋“ค๋กœ ์ธ์‚ฐ์ธํ•ด๋ฅผ ์ด๋ฃจ๋Š” ๊ณณ์ด๋‹ค. ์˜ค๋Š˜์€ ํŒ๊ต ์ ์‹ฌ ๋ง›์ง‘์œผ๋กœ ๊ดœ์ฐฎ์€ ๊ณณ ๋‘ ๊ตฐ๋ฐ๋ฅผ ์†Œ๊ฐœํ•ด ๋ณธ๋‹ค. 1.... \n   URL: http://jdcamping.tistory.com/1374\n   ์ธ๋„ค์ผ: https://search2.kakaocdn.net/thumb/R180x180/?fname=https%3A%2F%2Fblog.kakaocdn.net%2Fdn%2FcQv0tX%2FbtrOfR4oUu3%2FdKQGkK0kY6kKk40f4kYkYK%2Fimg.jpg&token=1c251bb24ae4bb01657303012e2641ac\n   ๋‚ ์งœ: 2024. 12. 17.\n\nํ˜„์žฌ ํŽ˜์ด์ง€๊ฐ€ ๋งˆ์ง€๋ง‰ ํŽ˜์ด์ง€๊ฐ€ ์•„๋‹™๋‹ˆ๋‹ค. ๋” ๋งŽ์€ ๊ฒฐ๊ณผ๋ฅผ ๋ณด๋ ค๋ฉด page ๋งค๊ฐœ๋ณ€์ˆ˜๋ฅผ ์ฆ๊ฐ€์‹œํ‚ค์„ธ์š”.\n"
}
4. ์นดํŽ˜ ๊ฒ€์ƒ‰ (mcp_kakao_map_search_cafe)

ํ˜ธ์ถœ (Request):

{
  "tool_name": "mcp_kakao_map_search_cafe",
  "parameters": {
    "query": "์ฝ”๋”ฉ ์Šคํ„ฐ๋””",
    "size": 1
  }
}

์‘๋‹ต (Response - ์˜ˆ์‹œ):

{
  "tool_name": "mcp_kakao_map_search_cafe",
  "result": "์นดํŽ˜ ๊ฒ€์ƒ‰ ๊ฒฐ๊ณผ (์ด 18335๊ฐœ ์ค‘ 1๊ฐœ ํ‘œ์‹œ):\n\n1. ์นดํŽ˜๋ช…: ๋…์ทจ์‚ฌ-์ทจ์—…,๋Œ€ํ•™์ƒ,๋Œ€๊ธฐ์—…,๊ณต๊ธฐ์—…,NCS,์ธ์ ์„ฑ,์ทจ์—…์นดํŽ˜\n   ์ œ๋ชฉ: [์Šคํ„ฐ๋””] ์›น๊ฐœ๋ฐœ/์ฝ”๋”ฉ ๊ธฐ์ดˆ ์Šคํ„ฐ๋”” ๊ตฌํ•ด์š”\n   ๋‚ด์šฉ: ์•ˆ๋…•ํ•˜์„ธ์š”! ์›น๊ฐœ๋ฐœ ๋ฐ ์ฝ”๋”ฉ ๊ธฐ์ดˆ๋ฅผ ํ•จ๊ป˜ ๊ณต๋ถ€ํ•  ์Šคํ„ฐ๋””์›์„ ๋ชจ์ง‘ํ•ฉ๋‹ˆ๋‹ค. ํ˜„์žฌ 2๋ช…์ด๋ฉฐ, ์ตœ๋Œ€ 4๋ช…๊นŒ์ง€ ์ƒ๊ฐํ•˜๊ณ  ์žˆ์Šต๋‹ˆ๋‹ค. ์žฅ์†Œ๋Š” ์ฃผ๋กœ ๊ฐ•๋‚จ/์‚ฌ๋‹น์—์„œ ์ง„ํ–‰ํ•˜๊ณ , ์˜จ๋ผ...\n   URL: http://cafe.daum.net/breakjob/DldL/12345\n   ์ธ๋„ค์ผ: https://search1.kakaocdn.net/thumb/P180x180/?fname=https%3A%2F%2Ft1.daumcdn.net%2Fcafe_image%2F%2Fconfig%2Fimg_default_profile%3Fver%3D1&token=de43b9d06222d0a2192f9f70fcb0f134\n   ๋‚ ์งœ: 2025. 3. 28.\n\nํ˜„์žฌ ํŽ˜์ด์ง€๊ฐ€ ๋งˆ์ง€๋ง‰ ํŽ˜์ด์ง€๊ฐ€ ์•„๋‹™๋‹ˆ๋‹ค. ๋” ๋งŽ์€ ๊ฒฐ๊ณผ๋ฅผ ๋ณด๋ ค๋ฉด page ๋งค๊ฐœ๋ณ€์ˆ˜๋ฅผ ์ฆ๊ฐ€์‹œํ‚ค์„ธ์š”.\n"
}

์„ค์น˜ ๋ฐ ์„ค์ •

  1. ์ €์žฅ์†Œ ๋ณต์ œ ๋ฐ ์ข…์†์„ฑ ์„ค์น˜:
git clone https://github.com/yousleepwhen/kakao-api-mcp-server.git # ์ €์žฅ์†Œ URL์„ ์‹ค์ œ URL๋กœ ๋ณ€๊ฒฝํ•ด์ฃผ์„ธ์š”
cd kakao-api-mcp-server
yarn install
  • ์ด ํ”„๋กœ์ ํŠธ๋Š” yarn ํŒจํ‚ค์ง€ ๋งค๋‹ˆ์ € ์‚ฌ์šฉ์„ ๊ถŒ์žฅํ•ฉ๋‹ˆ๋‹ค.
  1. ์นด์นด์˜ค REST API ํ‚ค ์„ค์ •:
    • ํ”„๋กœ์ ํŠธ ๋ฃจํŠธ ๋””๋ ‰ํ† ๋ฆฌ์— .env ํŒŒ์ผ์„ ์ƒ์„ฑํ•ฉ๋‹ˆ๋‹ค.
    • .env ํŒŒ์ผ ์•ˆ์— ๋‹ค์Œ๊ณผ ๊ฐ™์ด ์นด์นด์˜ค ๋””๋ฒจ๋กœํผ์Šค์—์„œ ๋ฐœ๊ธ‰๋ฐ›์€ REST API ํ‚ค๋ฅผ ์ž…๋ ฅํ•ฉ๋‹ˆ๋‹ค:
      KAKAO_REST_API_KEY=์—ฌ๊ธฐ์—_์นด์นด์˜ค_REST_API_ํ‚ค_์ž…๋ ฅ
      
    • ๋˜๋Š”, ์„œ๋ฒ„ ์‹คํ–‰ ์‹œ --kakao-api-key ์ธ์ž๋ฅผ ํ†ตํ•ด ์ง์ ‘ ์ „๋‹ฌํ•  ์ˆ˜๋„ ์žˆ์Šต๋‹ˆ๋‹ค.

์‹คํ–‰ ๋ฐฉ๋ฒ•

์„œ๋ฒ„๋ฅผ ์‹คํ–‰ํ•˜๊ธฐ ์ „์— ์ฝ”๋“œ๋ฅผ ๋นŒ๋“œํ•ด์•ผ ํ•ฉ๋‹ˆ๋‹ค. start ๊ด€๋ จ ์Šคํฌ๋ฆฝํŠธ์— ๋นŒ๋“œ ๊ณผ์ •์ด ํฌํ•จ๋˜์–ด ์žˆ์œผ๋ฏ€๋กœ ๋ณ„๋„๋กœ yarn build๋ฅผ ์‹คํ–‰ํ•  ํ•„์š”๋Š” ์—†์Šต๋‹ˆ๋‹ค.

HTTP ๋ชจ๋“œ (๊ธฐ๋ณธ)

๋‹ค๋ฅธ ์„œ๋น„์Šค๋‚˜ ๋„๊ตฌ์™€ HTTP๋ฅผ ํ†ตํ•ด ํ†ต์‹ ํ•  ๋•Œ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค.

yarn start

๊ธฐ๋ณธ์ ์œผ๋กœ 3000๋ฒˆ ํฌํŠธ๋ฅผ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค. ํฌํŠธ๋ฅผ ๋ณ€๊ฒฝํ•˜๋ ค๋ฉด --port ์ธ์ž๋ฅผ ์‚ฌ์šฉํ•˜์„ธ์š”:

yarn start --port 8080

stdio ๋ชจ๋“œ

ํ„ฐ๋ฏธ๋„์˜ ํ‘œ์ค€ ์ž…์ถœ๋ ฅ(stdin/stdout)์„ ํ†ตํ•ด MCP ๋ฉ”์‹œ์ง€๋ฅผ ์ฃผ๊ณ ๋ฐ›์„ ๋•Œ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค.

yarn start:stdio

๊ฐœ๋ฐœ ๋ชจ๋“œ

๊ฐœ๋ฐœ ์ค‘ ์ฝ”๋“œ ๋ณ€๊ฒฝ ์‹œ ์ž๋™์œผ๋กœ ๋นŒ๋“œํ•˜๊ณ  ์„œ๋ฒ„๋ฅผ ์žฌ์‹œ์ž‘ํ•˜๋ ค๋ฉด (nodemon ๋“ฑ ๋ณ„๋„ ์„ค์ • ํ•„์š”) dev ์Šคํฌ๋ฆฝํŠธ๋ฅผ ํ™œ์šฉํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ํ˜„์žฌ dev ์Šคํฌ๋ฆฝํŠธ๋Š” start์™€ ๋™์ผํ•˜๊ฒŒ ๋™์ž‘ํ•ฉ๋‹ˆ๋‹ค.

yarn dev

๋ผ์ด์„ ์Šค

์ด ํ”„๋กœ์ ํŠธ๋Š” MIT ๋ผ์ด์„ ์Šค ํ•˜์— ๋ฐฐํฌ๋ฉ๋‹ˆ๋‹ค.