mcp-meteoblue

MCP-сервер для meteoblue Weather API, написанный на JavaScript. Он позволяет MCP-клиентам искать местоположения, получать прогнозы с использованием пакетов, доступных через Free Weather API, и запрашивать изображения метеограмм прогноза.

Инструменты

• search_locations находит города, почтовые индексы и коды аэропортов IATA/ICAO через meteoblue Location Search.

• get_forecast принимает либо название места, либо координаты и возвращает JSON с прогнозом. По умолчанию он выдаёт текущую, почасовую и суточную погоду.

• get_forecast_image принимает либо название места, либо координаты и возвращает изображение прогноза напрямую MCP-клиенту.

Названия мест, передаваемые в инструменты прогноза и изображений, всегда определяются с помощью официального API meteoblue Location Search. Входные данные пакетов прогноза ограничены пакетами, перечисленными в документации Free Weather API.

[!NOTE] В текущей документации Free Weather API от meteoblue указано, что изображения требуют более высокого уровня доступа. Инструмент изображений включён для ключей с правом Image API, в противном случае он вернёт понятную ошибку авторизации.

Related MCP server: mcp-weather-server

Требования

• Node.js 20 или новее

• ключ API meteoblue

Храните ключ в секрете. Сервер считывает его из 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 .

Настройте stdio-сервер на базе Docker в вашем MCP-клиенте:

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

Контейнер работает от непривилегированного пользователя node. Используйте -i, чтобы держать stdin открытым, так как обмен данными с MCP выполняется через stdio.

Локальная разработка

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 запускает тестовый набор и проверяет npm-архив на Node.js 20, 22, 24 и 26 при каждом push и pull request. Dependabot еженедельно проверяет зависимости npm и GitHub Actions.

При push Git-тега v* запускается .github/workflows/publish.yml. Workflow использует npm trusted publishing (OIDC) и автоматически прикрепляет provenance.

Настройте npm trusted publisher со следующими параметрами:

• Владелец GitHub: unixfox

• Репозиторий: mcp-meteoblue

• Рабочий процесс: publish.yml

• Окружение: npm

Если настроен trusted publishing, в GitHub не сохраняется ни один npm-токен.

Ограничения 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