mcp-weather-connector

MCP-сервер является частью экосистемы, но данная документация для кого-то, кто хочет предоставить ИИ-агенту доступ к прогнозу погоды через Open-Meteo — публичное API без ключа и регистрации.

Небольшой, намеренно: репозиторий про то, как устроен инструментальный слой для агента, а не про погоду. Погода здесь — понятный способ показать границу доверия между моделью и внешним миром.

Зачем это

Model Context Protocol — способ дать языковой модели право совершать действия во внешних сервисах. Как только такое право появляется, возникает вопрос: что будет, если модель передаст в инструмент мусор, а чужой сервис в этот момент отдаст 503.

Три решения, которые в этом коде показаны явно:

Вход от модели — недоверенный. Модель может работать с пустой строкой, целым текстом на десять килобайт или управляющими символами. Всё это отсекается в server.py до сетевого вызова, а не в чужом API.

Ошибки различаются по основному. 4xx повторять бессмысленно — это ошибка запроса, повтор её не исправит. 5xx чаще разовый сбой — один повтор с паузой. Логика в _get_json, проверяется тестами на счётчик вызовов.

Наружу выходит текст, а не сырой JSON. Агенту нечего пересказывать и негде ошибиться при пересказе. Ответ 200 без нужного поля означает сбой, а не повод отдавать пустоту.

Отдельно: число дней вне диапазона приводится к границе, а не считается ошибкой. Если модель попросила прогноз на 30 дней, полезнее отдать 7, чем потерять диалог сообщением об ошибке.

Related MCP server: open-meteo-mcp-server

Инструменты

locate создан только для сценария: когда агент не уверен в написании, лучше уточнить у пользователя, чем просто выдать погоду не того города.

Установка

pip install -e .

Подключение к Claude Desktop

Укажите claude_desktop_config.json в конфигурации:

{
  "mcpServers": {
    "weather": {
      "command": "mcp-weather"
    }
  }
}

После перезапуска приложения инструменты будут в списке доступных.

Разработка

pip install -e ".[dev]"
pytest
ruff check .

Тесты покрывают то, что реально может сломаться: пустой и некорректный ввод, нечисловое количество дней, 4xx без повтора, 5xx с повтором, успех со второй попытки, ответ 200 без полезной нагрузки, неизвестный код погоды. HTTP замокан через respx — сеть в тестах не нужна.

Структура

src/mcp_weather/
    client.py    — работа с Open-Meteo: типы, повторы, разбор ответа
    server.py    — MCP-слой: валидация входа и форматирование вывода
tests/
    test_tools.py

Сетевой код отделён от MCP-слоя явно: клиент, который сам себя тестирует, а инструменты агента остаются тонкой обёрткой над понятными функциями.

Лицензия

MIT