mcp-meteoblue

meteoblue Weather API를 위한 JavaScript 기반 MCP 서버입니다. MCP 클라이언트가 위치를 검색하고, Free Weather API에서 제공하는 패키지를 사용해 예보를 가져오며, 예보 메테오그램 이미지를 요청할 수 있습니다.

도구

• search_locations는 meteoblue Location Search로 도시, 우편번호, IATA/ICAO 공항 코드를 확인합니다.

• get_forecast는 주소 이름 또는 좌표를 받아 예보 JSON을 반환합니다. 기본적으로 현재 날씨, 시간별 날씨, 일별 날씨를 제공합니다.

• get_forecast_image는 주소 이름 또는 좌표를 받아 예보 이미지를 MCP 클라이언트에 직접 반환합니다.

예보 또는 이미지 도구에 전달되는 주소 이름은 항상 공식 meteoblue Location Search API를 통해 확인됩니다. 예보 패키지 입력은 Free Weather API 문서에 나열된 패키지로 제한됩니다.

[!NOTE] meteoblue의 현재 Free Weather API 문서에 따르면 이미지를 사용하려면 더 높은 액세스 수준이 필요합니다. 이미지 도구는 Image API 권한이 있는 키를 위해 포함되며, 그 외에는 명확한 인증 오류를 반환합니다.

Related MCP server: mcp-weather-server

요구 사항

• Node.js 20 이상

• meteoblue API 키

키는 비공개로 유지하세요. 이 서버는 METEOBLUE_API_KEY에서 키를 읽으므로, 키가 패키지나 MCP 도구 인자에 포함되지 않습니다.

npm에서 실행

이 stdio 서버를 MCP 클라이언트 구성에 추가하세요:

{
  "mcpServers": {
    "meteoblue": {
      "command": "npx",
      "args": ["-y", "mcp-meteoblue"],
      "env": {
        "METEOBLUE_API_KEY": "your_api_key_here"
      }
    }
  }
}

또는 직접 실행하세요:

METEOBLUE_API_KEY=your_api_key_here npx -y mcp-meteoblue

서버는 stdio를 사용하므로 MCP 클라이언트를 기다리는 동안 의도적으로 일반적인 터미널 출력을 생성하지 않습니다.

Docker

로컬에서 이미지를 빌드하세요:

docker build -t mcp-meteoblue .

MCP 클라이언트에 Docker 기반 stdio 서버를 구성하세요:

{
  "mcpServers": {
    "meteoblue": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "--env",
        "METEOBLUE_API_KEY",
        "mcp-meteoblue"
      ],
      "env": {
        "METEOBLUE_API_KEY": "your_api_key_here"
      }
    }
  }
}

컨테이너는 권한이 없는 node 사용자로 실행됩니다. MCP 통신이 stdio를 사용하므로 -i 옵션으로 stdin을 열어 두세요.

로컬 개발

npm install
npm test
METEOBLUE_API_KEY=your_api_key_here npm start

MCP 클라이언트를 node /absolute/path/to/mcp-meteoblue/src/index.js로 지정하고 해당 클라이언트 구성에서 환경 변수를 설정하세요.

릴리스

GitHub Actions는 모든 푸시와 풀 리쿼스트에 대해 Node.js 20, 22, 24, 26에서 테스트 스위트를 실행하고 npm 터볼을 검증합니다. Dependabot는 매주 npm 및 GitHub Actions 종속성을 확인합니다.

v* Git 태그를 푸시하면 .github/workflows/publish.yml이 실행됩니다. 이 워크플로는 npm 신뢰 퍼블리싱(OIDC)을 사용하며 자동으로 출처 기록(provenance)을 첨부합니다. npm 신뢰 퍼블리셔를 다음과 같이 구성하세요:

• GitHub 소유자: unixfox

• 저장소: mcp-meteoblue

• 워크플로: publish.yml

• 환경: npm

신뢰 퍼블리싱을 구성한 경우 npm 토큰은 GitHub에 저장되지 않습니다.

API 범위

이 서버는 다음만 호출합니다:

• https://www.meteoblue.com/{language}/server/search/query3

• https://my.meteoblue.com/packages/{packages}

• https://my.meteoblue.com/images/{forecast-image-type}

meteoblue History, Dataset, Maps, Measurements 또는 기타 API는 노출하지 않습니다.

라이선스

MIT