mcpapp1 — MCP-сервер погоды

Небольшой Model Context Protocol сервер, который предоставляет текущие предупреждения о погоде в США MCP-клиентам, таким как Claude Desktop, Claude Code и Cursor.

Данные берутся из National Weather Service API, который бесплатен и не требует API-ключа.

Что он предоставляет

Related MCP server: Weather Alert & Forecast MCP Tool

Требования

• Python 3.13+

• uv

Установка

git clone https://github.com/eyosiasbisrat/mcpapp1.git
cd mcpapp1
uv sync

Запуск

Запустите сервер напрямую через stdio:

uv run server/weather.py

Или через MCP CLI:

uv run mcp run server/weather.py

Проверьте его в интерактивном режиме в MCP Inspector:

uv run mcp dev server/weather.py

MCP-сервер общается по JSON-RPC через stdin/stdout, поэтому при ручном запуске он просто молча ждёт ввода. Это нормально — обычно его запускает клиент.

Подключение клиента

Claude Code / Cursor

Оба конфига уже добавлены в репозиторий и используют относительные пути, поэтому после uv sync они работают без правок:

• .mcp.json — Claude Code

• .cursor/mcp.json — Cursor

Перезагрузите окно редактора и подтвердите запуск сервера по запросу.

Claude Desktop

uv run mcp install server/weather.py

Затем полностью завершите Claude Desktop — включая значок в трее, так как закрытие окна оставляет его работающим, — и откройте снова.

Если при этом выводится Claude app not found, хотя Claude Desktop точно установлен, см. ниже.

Устранение неполадок

Claude app not found в Windows

mcp install ищет конфиг Claude Desktop в фиксированном месте:

%APPDATA%\Claude

Если Claude Desktop установлен как пакет MSIX / Microsoft Store, его данные перенаправляются в контейнер пакета, и этого каталога никогда не существует:

%LOCALAPPDATA%\Packages\Claude_<id>\LocalCache\Roaming\Claude\claude_desktop_config.json

Два способа решить проблему.

Отредактируйте настоящий конфиг напрямую — добавьте запись mcpServers в claude_desktop_config.json по указанному выше пути пакета, сохранив все существующие ключи.

Или один раз свяжите пути с помощью junction-ссылки на каталог, после чего mcp install будет нормально работать для любого сервера:

cmd /c mklink /J "%APPDATA%\Claude" "%LOCALAPPDATA%\Packages\Claude_<id>\LocalCache\Roaming\Claude"

Подставьте фактическое имя папки пакета вместо Claude_<id>. Чтобы отменить это, cmd /c rmdir "%APPDATA%\Claude" удалит только ссылку, а не конфиг.

При ручной регистрации сервера в Windows используйте абсолютный путь к uv (например, C:\Users\<you>\.local\bin\uv.exe). Упакованные приложения не всегда надёжно наследуют PATH из вашей оболочки, поэтому голый uv может не запуститься.

Проверка, что сервер действительно загружен

Убедитесь, что клиент запустил его, проверив родительский процесс:

Get-CimInstance Win32_Process -Filter "Name='uv.exe'" | ForEach-Object {
  $p = Get-CimInstance Win32_Process -Filter "ProcessId=$($_.ParentProcessId)"
  "$($_.ProcessId) <- $($p.Name)"
}

Если родительским процессом uv.exe является Claude.exe, значит сервер работает. Обратите внимание: некоторые сборки Claude Desktop не пишут отдельные логи серверов в logs\, поэтому пустая папка логов не является признаком сбоя.

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

server/weather.py     the MCP server: tool, resource, and NWS client
main.py               placeholder entrypoint
.mcp.json             Claude Code server config
.cursor/mcp.json      Cursor server config
pyproject.toml        dependencies (httpx, mcp[cli])

Примечания

• get_alerts охватывает только штаты США, поскольку NWS — агентство США.

• Запросы содержат заголовок User-Agent, который требуется NWS API.

• Сетевые и HTTP-ошибки перехватываются и отображаются как дружелюбное сообщение «unable to fetch» вместо traceback.