weather-agent-mcp 0.1.5 → 0.1.7
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.env.example +8 -0
- package/README.md +44 -1
- package/dist/weather-mcp.js +1299 -539
- package/package.json +1 -1
package/.env.example
CHANGED
|
@@ -7,11 +7,19 @@ OPENAI_MODEL=gpt-4o-mini
|
|
|
7
7
|
ANTHROPIC_API_KEY=
|
|
8
8
|
ANTHROPIC_MODEL=claude-3-5-haiku-latest
|
|
9
9
|
|
|
10
|
+
# Weather source. Default is Open-Meteo. yandex needs both keys below.
|
|
11
|
+
# Historical same-day archive is Open-Meteo only; yandex returns UNSUPPORTED.
|
|
12
|
+
WEATHER_PROVIDER=open-meteo
|
|
13
|
+
|
|
10
14
|
# Open-Meteo base URLs (override in tests with fake server)
|
|
11
15
|
OPEN_METEO_FORECAST_URL=https://api.open-meteo.com
|
|
12
16
|
OPEN_METEO_ARCHIVE_URL=https://archive-api.open-meteo.com
|
|
13
17
|
OPEN_METEO_GEOCODING_URL=https://geocoding-api.open-meteo.com
|
|
14
18
|
|
|
19
|
+
# Yandex adapter (used only when WEATHER_PROVIDER=yandex)
|
|
20
|
+
YANDEX_WEATHER_API_KEY=
|
|
21
|
+
YANDEX_GEOCODER_API_KEY=
|
|
22
|
+
|
|
15
23
|
# Agent defaults
|
|
16
24
|
AGENT_MAX_ITERATIONS=10
|
|
17
25
|
AGENT_MAX_TOOL_CALLS=20
|
package/README.md
CHANGED
|
@@ -58,7 +58,50 @@ sudo launchctl config user path "$HOME/.volta/bin:/usr/bin:/bin:/usr/sbin:/sbin"
|
|
|
58
58
|
|
|
59
59
|
Без `sudo`: можно `launchctl setenv PATH "$HOME/.volta/bin:/usr/bin:/bin:/usr/sbin:/sbin"` и перезапустить Cursor (сбросится после reboot).
|
|
60
60
|
|
|
61
|
-
Reload MCP. Tools: `geocode`, `getCurrentWeather`, `getForecast`, `getHistoricalWeather`, `compareWeather`.
|
|
61
|
+
Reload MCP. Tools: `geocode`, `getCurrentWeather`, `getForecast`, `getHistoricalWeather`, `compareWeather`. Для ряда температур (прогноз, архив одного дня по годам, сравнение) к ответу прилагается PNG-график.
|
|
62
|
+
|
|
63
|
+
По умолчанию источник — Open-Meteo. `WEATHER_PROVIDER=yandex` переключает геокод на Яндекс Геокодер и прогноз на Яндекс.Погоду. Архив одного дня за годы на Яндексе не поддержан. Откуда взять ключи — в разделе ниже.
|
|
64
|
+
|
|
65
|
+
### Ключи Яндекса
|
|
66
|
+
|
|
67
|
+
Нужны оба ключа. Это разные продукты: ключ Геокодера не открывает Погоду, и наоборот.
|
|
68
|
+
|
|
69
|
+
**`YANDEX_GEOCODER_API_KEY`** — HTTP Геокодер Яндекс Карт.
|
|
70
|
+
|
|
71
|
+
1. Войдите в [Кабинет разработчика](https://developer.tech.yandex.ru/) с Яндекс ID.
|
|
72
|
+
2. Нажмите «Подключить API» и выберите «JavaScript API и HTTP Геокодер».
|
|
73
|
+
3. Заполните форму. Ключ появится в разделе «Ключи». Он начинает отвечать примерно через 15 минут ([формат запроса Геокодера](https://yandex.ru/dev/geocode/doc/ru/request)).
|
|
74
|
+
|
|
75
|
+
**`YANDEX_WEATHER_API_KEY`** — API Яндекс Погоды.
|
|
76
|
+
|
|
77
|
+
1. Войдите в [личный кабинет Яндекс Погоды для бизнеса](https://yandex.ru/pogoda/b2b/console) с Яндекс ID.
|
|
78
|
+
2. Выберите тариф. Пробный доступ на 7 дней описан на [странице API](https://yandex.ru/dev/weather/). После выбора тарифа ключ появляется в кабинете и активируется через несколько минут ([аутентификация](https://yandex.ru/dev/weather/doc/ru/concepts/auth)).
|
|
79
|
+
|
|
80
|
+
В `.env` для `npm run ask` и `npm run mcp`:
|
|
81
|
+
|
|
82
|
+
```bash
|
|
83
|
+
WEATHER_PROVIDER=yandex
|
|
84
|
+
YANDEX_GEOCODER_API_KEY=
|
|
85
|
+
YANDEX_WEATHER_API_KEY=
|
|
86
|
+
```
|
|
87
|
+
|
|
88
|
+
Опубликованный `npx weather-agent-mcp` файл `.env` не читает. В Cursor ключи передаются в `env` конфига MCP:
|
|
89
|
+
|
|
90
|
+
```json
|
|
91
|
+
{
|
|
92
|
+
"mcpServers": {
|
|
93
|
+
"open-meteo-weather": {
|
|
94
|
+
"command": "npx",
|
|
95
|
+
"args": ["-y", "weather-agent-mcp"],
|
|
96
|
+
"env": {
|
|
97
|
+
"WEATHER_PROVIDER": "yandex",
|
|
98
|
+
"YANDEX_GEOCODER_API_KEY": "",
|
|
99
|
+
"YANDEX_WEATHER_API_KEY": ""
|
|
100
|
+
}
|
|
101
|
+
}
|
|
102
|
+
}
|
|
103
|
+
}
|
|
104
|
+
```
|
|
62
105
|
|
|
63
106
|
### GitHub Copilot / VS Code
|
|
64
107
|
|