Open-Meteo MCP Server

Небольшой MCP (Model Context Protocol) сервер, который даёт ИИ-ассистенту вроде Claude возможность получать реальные данные о погоде — текущие условия и прогнозы — оборачивая бесплатный Open-Meteo API. API-ключ не требуется.

Создан как учебный проект, чтобы понять, как работают MCP-серверы, от начала до конца: определение инструментов, их локальный запуск и подключение к реальному ИИ-клиенту.

Что он делает

После подключения к MCP-совместимому клиенту (например, Claude) он предоставляет три инструмента:

Так что человек может спросить ассистента: «Какая погода завтра в Лиссабоне?» — и ассистент сам вызовет эти инструменты, чтобы узнать ответ. Он не запрограммирован с данными о погоде заранее, а получает их в реальном времени.

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 start

HTTP-режим (для подключения удалённого клиента, например, через переадресованный порт Codespaces или хостинг-провайдера):

node build/http.js

Это запускает обычный HTTP-сервер на порту 3000 (настраивается через PORT) с единственной MCP-точкой по адресу POST /mcp и проверкой GET /health.

Проверка без клиента

CLI-режим MCP Inspector — это самый быстрый способ «пощупать» сервер прямо из терминала; браузер не нужен:

# 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=London

Подключение к ИИ-ассистенту

• Claude Desktop / Claude Code: укажите build/index.js как stdio MCP-сервер в конфигурации клиента.

• Пользовательские коннекторы Claude.ai: укажите URL /mcp запущенного HTTP-экземпляра (требуется тарифный план, который поддерживает пользовательские коннекторы).

• Напрямую через Anthropic API: передайте URL /mcp в параметре mcp_servers запроса /v1/messages — это позволяет любому пользовательскому приложению или странице использовать инструменты без готового MCP-клиента.

Заметки по расширению

Open-Meteo предоставляет гораздо больше переменных и конечных точек, чем используется в этом проекте (качество воздуха, морские прогнозы, исторические/архивные данные, ансамбли). Чтобы добавить новые, следуйте образцу существующего инструмента в src/server.ts — зарегистрируйте новый блок server.tool(...) со своей схемой ввода и запросом к Open-Meteo.

Данные © Open-Meteo.com, CC BY 4.0.