Open-Meteo MCP Server
Open-Meteo MCP Server
간단한 MCP(Model Context Protocol) 서버로, Claude와 같은 AI 어시스턴트가 무료 Open-Meteo API를 래핑하여 실제 날씨 데이터(현재 상태와 예보)를 조회할 수 있게 해줍니다. API 키가 필요 없습니다.
도구 정의, 로컬 실행, 실제 AI 클라이언트 연결까지 MCP 서버가 엔드 투 엔드로 작동하는 방식을 이해하기 위한 학습 프로젝트로 제작되었습니다.
기능
MCP 호환 클라이언트(예: Claude)에 연결되면 세 가지 도구가 노출됩니다:
도구 | 기능 |
| 장소 이름("London")을 좌표로 변환 |
| 해당 좌표의 현재 기온, 바람, 강수량 등 |
| 해당 좌표의 최대 16일 예보(일별 및/또는 시간별) |
그래서 사용자가 어시스턴트에게 "내일 리스본 날씨는 어때?"라고 물으면, 어시스턴트가 직접 이 도구들을 호출해 알아내고 답할 수 있습니다. 날씨 데이터가 사전에 프로그래밍되어 있는 것이 아니라 실시간으로 가져옵니다.
Related MCP server: Weather MCP Server
구성 방식
src/server.ts— 세 가지 도구와 각 도구가 Open-Meteo API를 호출하는 방식을 정의합니다. 서버의 실제 "두뇌"에 해당하는 부분입니다.src/index.ts— 서버를 stdio(표준 입력/출력)로 실행합니다. 이 전송 방식은 MCP Inspector 같은 로컬 개발 도구와 서버를 하위 프로세스로 실행하는 데스크톱 앱에서 사용됩니다.src/http.ts— 동일한 서버를 Streamable HTTP로 실행하여 네트워크를 통해 접근할 수 있게 합니다(예: 어딘가에 호스팅하거나 브라우저 기반 클라이언트에서 접근). 이를 통해 로컬에 아무것도 설치하지 않고도 데모를 시연할 수 있습니다.
두 진입점 모두 server.ts의 동일한 도구 정의를 공유하므로 실제 로직이 존재하는 곳은 한곳뿐입니다.
실행하기
npm install
npm run build로컬/stdio 모드(서버를 하위 프로세스로 실행하는 도구용):
npm startHTTP 모드(원격 클라이언트 연결용, 예: 전달된 Codespaces 포트 또는 호스팅 제공업체를 통해):
node build/http.js이 명령은 PORT로 설정 가능한 3000번 포트에서 일반 HTTP 서버를 시작하며, POST /mcp에 단일 MCP 엔드포인트와 GET /health 상태 확인 엔드포인트를 제공합니다.
클라이언트 없이 테스트하기
MCP Inspector의 CLI 모드는 브라우저 없이 터미널에서 직접 확인해 볼 수 있는 가장 빠른 방법입니다:
# See what tools are available
npx @modelcontextprotocol/inspector --cli node build/index.js --method tools/list
# Actually call one
npx @modelcontextprotocol/inspector --cli node build/index.js \
--method tools/call --tool-name geocode_location --tool-arg name=LondonAI 어시스턴트에 연결하기
Claude Desktop / Claude Code: 클라이언트 설정에서
build/index.js를 stdio MCP 서버로 지정합니다.Claude.ai 맞춤 커넥터: 실행 중인 HTTP 인스턴스의
/mcpURL을 지정합니다(맞춤 커넥터를 허용하는 요금제 필요).Anthropic API 직접 사용:
/v1/messages요청의mcp_servers매개변수에/mcpURL을 전달합니다. 이렇게 하면 사전 구축된 MCP 클라이언트 없이도 모든 맞춤 앱이나 페이지에서 도구를 사용할 수 있습니다.
확장을 위한 참고 사항
Open-Meteo에는 이 프로젝트에서 사용하는 것보다 훨씬 더 많은 변수와 엔드포인트가 있습니다(대기 질, 해양 예보, 과거/아카이브 데이터, 앙상블). 더 추가하려면 src/server.ts에 있는 기존 도구의 패턴을 따라, 자체 입력 스키마와 Open-Meteo 요청을 가진 새 server.tool(...) 블록을 등록하세요.
데이터 © Open-Meteo.com, CC BY 4.0.
Available Tools
3 toolsgeocode_locationA
Look up geographic coordinates (latitude/longitude) for a place name, e.g. 'London', 'Paris, TX', or 'Tokyo'. Use this before calling the weather tools if you only have a place name rather than coordinates.
Inputs: name (required), count, language.
get_current_weatherA
Get the current weather conditions (temperature, wind, precipitation, etc.) for a specific latitude/longitude. Use geocode_location first if you only have a place name.
Inputs: latitude (required), longitude (required), timezone, wind_speed_unit, +1 more.
get_weather_forecastA
Get a multi-day hourly and/or daily weather forecast (up to 16 days) for a specific latitude/longitude. Use geocode_location first if you only have a place name. Defaults to a useful set of daily summary variables; pass include_hourly=true for hour-by-hour detail as well.
Inputs: latitude (required), longitude (required), timezone, forecast_days, +3 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool has a clearly distinct purpose: geocoding converts place names to coordinates, while the other two retrieve weather data. The current weather and forecast tools are differentiated by time horizon and description.
All tool names follow a consistent snake_case verb_noun pattern: geocode_location, get_current_weather, get_weather_forecast. The naming style is uniform and predictable.
With 3 tools, the server is tightly scoped for its purpose: location resolution, current conditions, and forecast. Each tool earns its place and the count feels complete without redundancy.
The core weather lookup flow is fully covered: geocode a place name, get current conditions, or get a forecast. Minor gaps exist such as historical weather data or alerts, but these are not essential for the apparent primary use case.
Maintenance
Related MCP Connectors
Global weather via Open-Meteo: forecast, historical, marine, air quality, geocoding, elevation.
Current weather and forecast lookup as an agent tool.
Worldwide place search with coordinates (Open-Meteo) — paid per call (x402/credits), 1 tools
Get current weather for any city and create images from your prompts. Streamline planning, reports…
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to fetch current weather conditions and forecasts for any city using the Open-Meteo API. Provides temperature, precipitation, and hourly forecast data through natural language queries.ISC
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to retrieve current weather, forecasts, and summaries for any global location using the Open-Meteo API, with no API key required.Creative Commons Zero v1.0 Universal
- AlicenseNot gradedqualityDmaintenanceProvides live weather data (current conditions, forecasts) and city geocoding through Open-Meteo API, enabling AI assistants to answer weather queries without an API key.MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to retrieve real-time weather conditions and 7-10 day forecasts for any location via Open-Meteo, with no API key required.144 npmMIT