Skip to main content
Glama
denverzp

mcp-weather-ukraine

by denverzp
README.md
# MCP-сервер Погоды для Украины

Этот проект реализует MCP сервер для получения актуальной информации о погоде, адаптированный для Украины. 
MCP (Model Context Protocol) сервер предоставляет один инструмент (tools):

- `get_forecast` — получение прогноза погоды для заданных координат.

Сервер построен на Node.js и использует MCP-протокол для интеграции с клиентами, такими как Claude for Desktop.

## Особенности

- Получение и форматирование данных о погоде с поддержкой особенностей украинского региона.
- Совместимость с MCP клиентами, позволяющая вызывать инструменты напрямую из окружения LLM (например, Claude).
- Пример конфигурации для интеграции с Claude for Desktop.

## Установка и запуск

Для сборки и запуска сервера выполните следующие команды:
``` sh
npm ci
npm run build
node .\build\index.js
```

Убедитесь, что установлен Node.js (рекомендуется версия 16 и выше).

## Конфигурация для Claude for Desktop

Чтобы использовать MCP сервер с Claude for Desktop, добавьте следующую конфигурацию в файл `claude_desktop_config.json`:
```
{
  "mcpServers": {
    "weather-ukraine": {
      "command": "node",
      "args": ["C:\\PATH\\TO\\CODE\\weather-ukraine\\build\\index.js"]
    }
  }
}
```

Где `C:\\PATH\\TO\\CODE\\weather-ukraine\\build\\index.js` — абсолютный путь к скомпилированному серверу на вашем ПК (используйте двойные обратные слеши для Windows).

После настройки перезапустите Claude for Desktop, чтобы MCP сервер появился в списке доступных инструментов и мог обрабатывать запросы по погоде в Украине.

## Как это работает

1. Клиент (например, Claude for Desktop) отправляет запрос.
2. MCP сервер анализирует запрос и вызывает нужный инструмент.
3. Сервер обращается к сторонним API для получения данных о погоде.
4. Полученные данные возвращаются клиенту в удобочитаемом виде.

## Требования

- Node.js 16+
- MCP клиент, поддерживающий протокол MCP (например, Claude for Desktop)

## Контакты и поддержка

Для вопросов и предложений по проекту используйте раздел Issues на GitHub или свяжитесь с разработчиком.

---

Адаптация сделана на основе оригинальной инструкции от [Model Context Protocol](https://modelcontextprotocol.io/docs/develop/build-server) с акцентом на украинский контекст.