kimcp
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
- Claude Desktop
- uv (Python ํจํค์ง ๊ด๋ฆฌ์)
- ๋ค์ด๋ฒ API Key
- ์นด์นด์ค API Key
- SK Open API Key
Installation
-
์ ์ฅ์ ๋ณต์
git clone https://github.com/zeikar/kimcp cd kimcp
-
Python ์์กด์ฑ ์ค์น
uv sync
-
ํ๊ฒฝ ๋ณ์ ์ค์
ํ๋ก์ ํธ ๋ฃจํธ์ ์ ๊ณต๋
.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 ํค๋ฅผ ์ ๋ ฅํ์ง ์์ผ๋ฉด ๋ค์ด๋ฒ ๊ด๋ จ ๋๊ตฌ๋ง ์ฌ์ฉ ๊ฐ๋ฅํฉ๋๋ค.
-
Claude Desktop์ ์ค์น
uv run mcp install main.py -f .env
-
๋ณ๊ฒฝ ์ฌํญ์ ์ ์ฉํ๋ ค๋ฉด Claude Desktop ์ฌ์์
Development
ํ ์คํธ ๋ฐ ๊ฐ๋ฐ์ ์ํ MCP inspector ์คํ:
uv run mcp dev main.py
Roadmap
- โ ๋ค์ด๋ฒ API ํตํฉ
- โ ์นด์นด์ค API ํตํฉ
- โ SK Open API ํตํฉ
- โฌ ๊ธฐ์์ฒญ(KMA) ํตํฉ
- ๊ธฐํ ๋ฑ๋ฑ
License
์ด ํ๋ก์ ํธ๋ MIT ๋ผ์ด์ผ์ค๋ฅผ ๋ฐ๋ฆ ๋๋ค. ์์ธํ ๋ด์ฉ์ ํ์ผ์ ์ฐธ์กฐํ์ธ์.