MCP Weather Server

MCP-сервер для запроса погоды на базе FastMCP, предоставляющий текущую погоду, прогнозы на будущее, конвертацию градусов Цельсия/Фаренгейта, ресурсы по популярным городам и промпты с советами по погоде для путешествий.

Проект содержит две точки входа для запуска:

• server.py: локальный режим stdio, подходит для локальных MCP-клиентов, таких как Claude Desktop, Cursor, Cherry Studio и др.

• server_remote.py: режим Streamable HTTP, подходит для развертывания на платформах удаленного хостинга, таких как ModelScope.

Функции

• get_weather(city: str): запрос текущей погоды в указанном городе.

• get_forecast(city: str, days: int = 3): запрос прогноза погоды в указанном городе на будущее, по умолчанию 3 дня.

• temperature_convert(value: float, from_unit: str): конвертация между градусами Цельсия и Фаренгейта.

• weather://cities: возвращает ресурс со списком популярных городов.

• travel_advisor(destination: str, date: str): генерация промпта с консультацией по погоде для путешествия.

Данные о погоде поступают из wttr.in, дополнительные API-токены не требуются.

Системные требования

• Python >= 3.12

• Рекомендуется использовать uv для управления зависимостями

Установка зависимостей

uv sync

Если вы не используете uv, вы также можете установить зависимости в виртуальной среде:

pip install "mcp[cli]>=1.27.0" "httpx>=0.28.1"

Локальный запуск

Режим stdio:

uv run python server.py

Пример конфигурации MCP-клиента:

{
  "mcpServers": {
    "weather-server": {
      "command": "uv",
      "args": ["run", "python", "server.py"]
    }
  }
}

Удаленный запуск

Режим Streamable HTTP:

uv run python server_remote.py

Прослушивание по умолчанию:

http://0.0.0.0:8000/mcp/

Пример конфигурации удаленного MCP-клиента:

{
  "mcpServers": {
    "weather-server": {
      "url": "http://127.0.0.1:8000/mcp/"
    }
  }
}

Инструкции по развертыванию на ModelScope

При создании или развертывании MCP Server на ModelScope вы можете указать адрес репозитория GitHub данного проекта и использовать файл удаленной точки входа:

python server_remote.py

Сервис запустится в режиме Streamable HTTP, прослушивая 0.0.0.0:8000, MCP-эндпоинт:

/mcp/

Если платформа поддерживает пользовательские команды запуска, рекомендуется использовать:

uv run python server_remote.py

Или использовать после предварительной установки зависимостей в среде платформы:

python server_remote.py

Структура проекта

.
├── README.md
├── pyproject.toml
├── server.py
├── server_remote.py
└── uv.lock

Лицензия

Если требуется публикация с открытым исходным кодом, пожалуйста, добавьте файл License в соответствии с фактической ситуацией.