kimcp

kimcp

3.3

If you are the rightful owner of kimcp 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.

KiMCP is a Model Context Protocol server that integrates various Korean APIs for use in LLM applications.

KiMCP (Korea-integrated Model Context Protocol)

|

KiMCP๋Š” Model Context Protocol (MCP)๋ฅผ ํ™œ์šฉํ•˜์—ฌ ๋„ค์ด๋ฒ„, ์นด์นด์˜ค, TMAP๊ณผ ๊ฐ™์€ ๊ตญ๋‚ด API๋“ค์„ LLM ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์—์„œ ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ๋Š” MCP ์„œ๋ฒ„์ž…๋‹ˆ๋‹ค.

Features

  • ๋„ค์ด๋ฒ„ ๋ธ”๋กœ๊ทธ ๊ฒ€์ƒ‰: ๋„ค์ด๋ฒ„์—์„œ ๋ธ”๋กœ๊ทธ ์ฝ˜ํ…์ธ  ๊ฒ€์ƒ‰
  • ๋„ค์ด๋ฒ„ ๋‰ด์Šค ๊ฒ€์ƒ‰: ๋„ค์ด๋ฒ„์—์„œ ๋‰ด์Šค ๊ธฐ์‚ฌ ๊ฒ€์ƒ‰
  • ๋„ค์ด๋ฒ„ ์นดํŽ˜ ๊ฒ€์ƒ‰: ๋„ค์ด๋ฒ„ ์นดํŽ˜ ์ปค๋ฎค๋‹ˆํ‹ฐ์—์„œ ๊ฒŒ์‹œ๋ฌผ ๊ฒ€์ƒ‰
  • ๋„ค์ด๋ฒ„ ์ง€์‹iN ๊ฒ€์ƒ‰: ๋„ค์ด๋ฒ„ ์ง€์‹iN์—์„œ Q&A ๊ฒŒ์‹œ๋ฌผ ๊ฒ€์ƒ‰
  • ๋„ค์ด๋ฒ„ ์ง€์—ญ ๊ฒ€์ƒ‰: ์ง€์—ญ ์—…์ฒด ๋ฐ ์žฅ์†Œ ์ •๋ณด ๊ฒ€์ƒ‰
  • ๋„ค์ด๋ฒ„ ์ด๋ฏธ์ง€ ๊ฒ€์ƒ‰: ๋„ค์ด๋ฒ„์—์„œ ์ด๋ฏธ์ง€ ๊ฒ€์ƒ‰
  • ๋„ค์ด๋ฒ„ ์‡ผํ•‘ ๊ฒ€์ƒ‰: ๋„ค์ด๋ฒ„ ์‡ผํ•‘์—์„œ ์ƒํ’ˆ ๊ฒ€์ƒ‰ ๋ฐ ๊ฐ€๊ฒฉ ๋น„๊ต
  • ๋‹ค์Œ ๋ธ”๋กœ๊ทธ ๊ฒ€์ƒ‰: ๋‹ค์Œ ๋ธ”๋กœ๊ทธ์—์„œ ๋ธ”๋กœ๊ทธ ์ฝ˜ํ…์ธ  ๊ฒ€์ƒ‰
  • ๋‹ค์Œ ์นดํŽ˜ ๊ฒ€์ƒ‰: ๋‹ค์Œ ์นดํŽ˜์—์„œ ๊ฒŒ์‹œ๋ฌผ ๊ฒ€์ƒ‰
  • ์นด์นด์˜ค๋งต ๊ฒ€์ƒ‰: ์นด์นด์˜ค๋งต์—์„œ ์žฅ์†Œ ๋ฐ ์—…์ฒด ์ •๋ณด ๊ฒ€์ƒ‰
  • ์ž๋™์ฐจ ๊ธธ์ฐพ๊ธฐ: ์นด์นด์˜ค๋งต์„ ์‚ฌ์šฉํ•˜์—ฌ ์ž๋™์ฐจ ๊ธธ์ฐพ๊ธฐ ์ •๋ณด ์ œ๊ณต
  • ๋Œ€์ค‘๊ตํ†ต ๊ธธ์ฐพ๊ธฐ: TMAP์„ ์‚ฌ์šฉํ•˜์—ฌ ๋Œ€์ค‘๊ตํ†ต ๊ธธ์ฐพ๊ธฐ ์ •๋ณด ์ œ๊ณต

ํ˜„์žฌ ๊ฐœ๋ฐœ ์ค‘...

Prerequisites

Installation

  1. ์ €์žฅ์†Œ ๋ณต์ œ

    git clone https://github.com/zeikar/kimcp
    cd kimcp
    
  2. Python ์˜์กด์„ฑ ์„ค์น˜

    uv sync
    
  3. ํ™˜๊ฒฝ ๋ณ€์ˆ˜ ์„ค์ •

    ํ”„๋กœ์ ํŠธ ๋ฃจํŠธ์— ์ œ๊ณต๋œ .env.example ํŒŒ์ผ์„ ์ฐธ๊ณ ํ•˜์—ฌ .env ํŒŒ์ผ์„ ์ƒ์„ฑํ•˜์„ธ์š”:

    # .env.example ํŒŒ์ผ์„ .env๋กœ ๋ณต์‚ฌ
    cp .env.example .env
    
    # ์ƒ์„ฑ๋œ .env ํŒŒ์ผ ํŽธ์ง‘
    vi .env   # ๋˜๋Š” ์›ํ•˜๋Š” ํ…์ŠคํŠธ ์—๋””ํ„ฐ ์‚ฌ์šฉ
    

    .env ํŒŒ์ผ์— ๋‹ค์Œ๊ณผ ๊ฐ™์ด API ํ‚ค๋ฅผ ์ž…๋ ฅํ•˜์„ธ์š”:

    NAVER_CLIENT_ID=your_naver_client_id
    NAVER_CLIENT_SECRET=your_naver_client_secret
    KAKAO_REST_API_KEY=your_kakao_rest_api_key
    SK_APP_KEY=your_sk_app_key
    

    ์ฐธ๊ณ :

    • ๋„ค์ด๋ฒ„ API ํ‚ค๋Š” ๋„ค์ด๋ฒ„ ๊ฐœ๋ฐœ์ž ์„ผํ„ฐ์—์„œ ๋ฐœ๊ธ‰ ๋ฐ›์„ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.
    • ์นด์นด์˜ค API ํ‚ค๋Š” ์นด์นด์˜ค Developers์—์„œ ๋ฐœ๊ธ‰ ๋ฐ›์„ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.
    • TMAP (SK Open API) ํ‚ค๋Š” SK Open API์—์„œ ๋ฐœ๊ธ‰ ๋ฐ›์„ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.
    • ํ•„์š”ํ•œ API๋งŒ ์‚ฌ์šฉํ•˜๋Š” ๊ฒฝ์šฐ, ํ•ด๋‹น API ํ‚ค๋งŒ ์„ค์ •ํ•ด๋„ ๋ฉ๋‹ˆ๋‹ค.
      • API ํ‚ค๋ฅผ ์ž…๋ ฅํ•˜์ง€ ์•Š์œผ๋ฉด ํ•ด๋‹น MCP ๋„๊ตฌ๊ฐ€ ์ž๋™์œผ๋กœ ๋น„ํ™œ์„ฑํ™”๋ฉ๋‹ˆ๋‹ค. ์˜ˆ๋ฅผ ๋“ค์–ด, ๋„ค์ด๋ฒ„ API ํ‚ค๋งŒ ์ž…๋ ฅํ•˜๊ณ  ์นด์นด์˜ค API ํ‚ค๋ฅผ ์ž…๋ ฅํ•˜์ง€ ์•Š์œผ๋ฉด ๋„ค์ด๋ฒ„ ๊ด€๋ จ ๋„๊ตฌ๋งŒ ์‚ฌ์šฉ ๊ฐ€๋Šฅํ•ฉ๋‹ˆ๋‹ค.
  4. Claude Desktop์— ์„ค์น˜

    uv run mcp install main.py -f .env
    
  5. ๋ณ€๊ฒฝ ์‚ฌํ•ญ์„ ์ ์šฉํ•˜๋ ค๋ฉด Claude Desktop ์žฌ์‹œ์ž‘

Development

ํ…Œ์ŠคํŠธ ๋ฐ ๊ฐœ๋ฐœ์„ ์œ„ํ•œ MCP inspector ์‹คํ–‰:

uv run mcp dev main.py

Roadmap

  • โœ… ๋„ค์ด๋ฒ„ API ํ†ตํ•ฉ
  • โœ… ์นด์นด์˜ค API ํ†ตํ•ฉ
  • โœ… SK Open API ํ†ตํ•ฉ
  • โฌœ ๊ธฐ์ƒ์ฒญ(KMA) ํ†ตํ•ฉ
  • ๊ธฐํƒ€ ๋“ฑ๋“ฑ

License

์ด ํ”„๋กœ์ ํŠธ๋Š” MIT ๋ผ์ด์„ผ์Šค๋ฅผ ๋”ฐ๋ฆ…๋‹ˆ๋‹ค. ์ž์„ธํ•œ ๋‚ด์šฉ์€ ํŒŒ์ผ์„ ์ฐธ์กฐํ•˜์„ธ์š”.

Acknowledgements