Korea Weather MCP Server

What is Korea Weather MCP Server?

This server integrates with the Korea Meteorological Administration's Short-term Forecast API and provides weather information to MCP clients such as Claude Desktop or Cursor. It is designed for developers who need to query Korean weather data through the Model Context Protocol.

How to use Korea Weather MCP Server?

Obtain an API key from data.go.kr for the 단기예보 API, then install via Smithery (npx -y @smithery/cli mcp add ohhan777/korea_weather --client claude) or clone the repository, set the KOREA_WEATHER_API_KEY environment variable, and configure your MCP client. Run locally with uv run korea_weather.py or uv run smithery dev for HTTP mode on port 8081.

Key features of Korea Weather MCP Server

• Connects to the Korea Meteorological Administration short‑term forecast API
• Delivers weather data in MCP‑compatible format
• Supports installation via Smithery or local clone
• Works with multiple MCP clients (Claude Desktop, Cursor)
• Includes an offline‑capable unit test suite

Use cases of Korea Weather MCP Server

• Asking for current weather at a specific location (e.g., Jeju International Airport)
• Checking whether to bring an umbrella for an afternoon trip to Seoul Namdaemun
• Determining if it is a good day to wash a car in the afternoon
• Inquiring about tomorrow's afternoon weather for planning outdoor activities

FAQ from Korea Weather MCP Server

How do I get an API key for Korea Weather MCP Server?

Apply for the 기상청 단기예보 API on data.go.kr and receive your API key. Set it as the KOREA_WEATHER_API_KEY environment variable.

Can I run Korea Weather MCP Server locally without Smithery?

Yes. Clone the repository, install dependencies with uv sync, set the API key environment variable, and run uv run korea_weather.py. Then configure your MCP client to use the server.

Which MCP clients does Korea Weather MCP Server support?

It supports any MCP host. Specific examples in the README include Claude Desktop and Cursor, and it can be used with Smithery Playground for interactive testing.

What dependencies does Korea Weather MCP Server require?

It uses Python and the uv package manager. It includes a fallback to standard library HTTP calls if httpx or dotenv are not installed.

Is there a way to test Korea Weather MCP Server offline?

Yes. The repository includes unit tests in tests/test_korea_weather.py that can run in an offline environment.