korea_weather

korea_weather

3.3

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

Korea Weather MCP Server is based on the Korea Meteorological Administration's short-term forecast API, providing weather information to MCP clients like Claude or Cursor.

Korea Weather MCP Server

๋ณธ MCP ์„œ๋ฒ„๋Š” ๊ธฐ์ƒ์ฒญ ๋‹จ๊ธฐ์˜ˆ๋ณด ์กฐํšŒ์„œ๋น„์Šค API๋ฅผ ๊ธฐ๋ฐ˜์œผ๋กœ ๋™์ž‘ํ•˜๋Š” MCP ์„œ๋ฒ„์ž…๋‹ˆ๋‹ค.

์†Œ๊ฐœ

Korea Weather MCP Server๋Š” ๊ธฐ์ƒ์ฒญ์˜ ๋‚ ์”จ ์ •๋ณด๋ฅผ ์ˆ˜์ง‘ํ•˜์—ฌ, MCP ํ”„๋กœํ† ์ฝœ์„ ํ†ตํ•ด Claude๋‚˜ Cursor์™€ ๊ฐ™์€ MCP ํด๋ผ์ด์–ธํŠธ(Host)์— ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค.
์ด ์„œ๋ฒ„๋Š” ๊ธฐ์ƒ ์ •๋ณด๋ฅผ ํ™œ์šฉํ•˜๋Š” ๋‹ค์–‘ํ•œ ์‘์šฉ ์„œ๋น„์Šค์— ์‰ฝ๊ฒŒ ์—ฐ๋™๋  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

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

  • ๊ธฐ์ƒ์ฒญ ๋‹จ๊ธฐ์˜ˆ๋ณด API ์—ฐ๋™
  • MCP ํ˜•์‹์˜ ๊ธฐ์ƒ ์ •๋ณด ์ œ๊ณต

์„ค์น˜ ๋ฐ ์‚ฌ์šฉ ๋ฐฉ๋ฒ•

Smithery๋ฅผ ์ด์šฉํ•œ ๊ฐ„ํŽธ ์„ค์น˜

  1. data.go.kr์—์„œ ๊ธฐ์ƒ์ฒญ ๋‹จ๊ธฐ์˜ˆ๋ณด API๋ฅผ ์‹ ์ฒญํ•˜๊ณ  API ํ‚ค๋ฅผ ๋ฐœ๊ธ‰๋ฐ›์Šต๋‹ˆ๋‹ค.
  2. ๋‹ค์Œ ๋ช…๋ น์–ด๋ฅผ ์‚ฌ์šฉํ•ด Smithery์—์„œ ์„œ๋ฒ„๋ฅผ ์„ค์น˜ํ•˜๊ณ  Claude Desktop์— ๋“ฑ๋กํ•ฉ๋‹ˆ๋‹ค.
    ์„ค์น˜ ๊ณผ์ •์—์„œ API ํ‚ค ์ž…๋ ฅ์„ ์š”๊ตฌํ•˜๋ฉด ๋ฐœ๊ธ‰๋ฐ›์€ ํ‚ค๋ฅผ ์ž…๋ ฅํ•ฉ๋‹ˆ๋‹ค.
    npx -y @smithery/cli install @ohhan777/korea_weather --client claude
    
  3. Claude Desktop์„ ์žฌ์‹œ์ž‘ํ•˜์—ฌ ์‚ฌ์šฉํ•˜๋ฉด ๋ฉ๋‹ˆ๋‹ค.

Github์—์„œ ์ง์ ‘ ์„ค์น˜ํ•˜๋Š” ๋ฐฉ๋ฒ•

  1. data.go.kr์—์„œ ๊ธฐ์ƒ์ฒญ ๋‹จ๊ธฐ์˜ˆ๋ณด API ํ™œ์šฉ ์‹ ์ฒญ ํ›„ API ํ‚ค๋ฅผ ๋ฐœ๊ธ‰๋ฐ›์Šต๋‹ˆ๋‹ค.

  2. github์—์„œ ์†Œ์Šค์ฝ”๋“œ๋ฅผ ๋‹ค์šด๋ฐ›์•„ ์‹คํ–‰ํ•ด๋ด…๋‹ˆ๋‹ค.

    git clone https://github.com/ohhan777/korea_weather.git
    cd korea_weather
    uv run korea_weather.py
    
  3. MCP ํด๋ผ์ด์–ธํŠธ(Host)์— ์„œ๋ฒ„๋ฅผ ๋“ฑ๋กํ•ฉ๋‹ˆ๋‹ค.

    • Claude Desktop์˜ ์„ค์ • ํŒŒ์ผ์€ ๋ณดํ†ต ์•„๋ž˜ ๊ฒฝ๋กœ์— ์œ„์น˜ํ•ฉ๋‹ˆ๋‹ค.
      C:\Users\[์‚ฌ์šฉ์ž ์ด๋ฆ„]\AppData\Roaming\Claude\claude_desktop_config.json
      (ํŒŒ์ผ์ด ์—†๋‹ค๋ฉด ์ƒˆ๋กœ ์ƒ์„ฑ)

    • Cursor์˜ ๊ฒฝ์šฐ: ์ƒ๋‹จ์˜ ํ†ฑ๋‹ˆ๋ฐ”ํ€ด ์•„์ด์ฝ˜(โš™๏ธ) โ†’ MCP โ†’ Add new global MCP server ์„ ํƒ

    ์•„๋ž˜ ์˜ˆ์‹œ์™€ ๊ฐ™์€ ํ˜•์‹์œผ๋กœ ์„ค์ • ํŒŒ์ผ์„ ์ž‘์„ฑํ•ฉ๋‹ˆ๋‹ค. (๋””๋ ‰ํ† ๋ฆฌ ๊ฒฝ๋กœ์™€ API ํ‚ค๋Š” ํ™˜๊ฒฝ์— ๋งž๊ฒŒ ์ˆ˜์ •)

    {
      "mcpServers": {
        "korea_weather": {
          "command": "uv",
          "args": [
            "--directory",
            "C:\\ai\\PyProjects\\korea_weather",  
            "run",
            "korea_weather.py"
          ],
          "env": {
            "KOREA_WEATHER_API_KEY": "Input Your API Key Here!"
          }
        }
      }
    }
    

ํ”„๋กฌํ”„ํŠธ ์˜ˆ์ œ

>> ์ œ์ฃผ ๊ตญ์ œ ๊ณตํ•ญ ํ˜„์žฌ ๋‚ ์”จ๋ฅผ ์•Œ๋ ค์ค˜.
>> ๋‚ด์ผ ์˜คํ›„์— ์„œ์šธ ๋‚จ๋Œ€๋ฌธ์— ๋†€๋Ÿฌ๊ฐ€๋ ค๊ณ  ํ•˜๋Š”๋ฐ ์šฐ์‚ฐ์„ ์ฑ™๊ฒจ์•ผํ• ๊นŒ?
>> ์˜ค๋Š˜ ์˜คํ›„์— ์„ธ์ฐจํ•˜๊ธฐ์— ๊ดœ์ฐฎ์€ ๋‚ ์”จ์ผ๊นŒ?

์˜์กด์„ฑ

pyproject.toml ์ฐธ๊ณ 

๋ผ์ด์„ ์Šค

๋ณธ ํ”„๋กœ์ ํŠธ๋Š” ๋‚ด๋ถ€ ์‹œํ—˜์šฉ์œผ๋กœ ๊ฐœ๋ฐœ๋˜์—ˆ์œผ๋ฉฐ, ๋ณ„๋„์˜ ๋ผ์ด์„ ์Šค ๊ทœ์ • ์—†์ด ์ž์œ ๋กญ๊ฒŒ ๋ฐฐํฌ ๋ฐ ์ˆ˜์ •์ด ๊ฐ€๋Šฅํ•ฉ๋‹ˆ๋‹ค.

๋ฌธ์˜

๊ฐœ๋ฐœ์ž: ํ•œ๊ตญํ•ญ๊ณต์šฐ์ฃผ์—ฐ๊ตฌ์› ์˜คํ•œ ()