About Fastmcp Weather Agent
Fastmcp Weather Agent is an MCP server in the Maps category.
Install
From source
git clone https://github.com/saltuwwa/fastmcp-weather-agentThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
✦
Ask AI about Fastmcp Weather Agent
Powered by Claude · Grounded in docs
I know everything about Fastmcp Weather Agent. Ask me about installation, configuration, usage, or troubleshooting.
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run yet.
README
WeatherAgent — ИИ-агент через FastMCP
Автономный ИИ-агент с инструментами погоды, заметок, браузера и поиска заведений. Создан по ТЗ воркшопа FastMCP.
⚠️ Убедись, что
.envв.gitignore— туда не должны попасть API-ключи.
✨ Возможности
| Инструмент | Описание |
|---|---|
get_weather |
Погода в городе (Open-Meteo API) |
save_note / list_notes / read_note |
Менеджер заметок |
browser_navigate / browser_snapshot |
Открытие сайтов и чтение страниц |
search_2gis |
Поиск заведений на карте 2GIS |
📁 Структура проекта
Подробнее: ARCHITECTURE.md
create-own-mcp/
├── weather_server.py # MCP-сервер (погода + заметки + браузер)
├── browser_tools.py # Инструменты браузера и 2GIS
├── chat_with_agent.py # Интерактивный чат с отображением шагов
├── requirements.txt # Зависимости
├── .env.example # Шаблон переменных окружения
├── .gitignore
├── README.md
└── my_notes/ # Папка для заметок (создаётся автоматически)
🚀 Быстрый старт
1. Установка
git clone https://github.com/ваш-username/create-own-mcp.git
cd create-own-mcp
pip install -r requirements.txt
playwright install chromium
2. Настройка
cp .env.example .env
# Отредактируй .env — добавь OPENAI_API_KEY
3. Запуск чата
python chat_with_agent.py
💬 Примеры запросов
Вы: Какая погода в Алматы?
📌 Шаг 1: get_weather(city_name='Алматы')
→ Погода в Almaty: 1.8°C, ветер 11.5 км/ч, небольшой дождь.
🤖 Ответ: Сейчас в Алматы около 2°C, ветер 11.5 км/ч...
Вы: Найди 5 кофеен в Алматы через 2GIS и выдай их адреса
📌 Шаг 1: search_2gis(query='кофейни', city='almaty', limit=5)
→ 1. Lova Coffee — Улица Толе би, 24Б
2. Mari central cafe — Микрорайон Мирас, 118
...
🤖 Ответ: Вот 5 кофеен в Алматы: 1. Lova Coffee...
Вы: Проверь погоду в Алматы. Если холодно — найди 3 кофейни в 2GIS. Сохрани план в evening_plan
📌 Шаг 1: get_weather(city_name='Алматы')
📌 Шаг 2: search_2gis(query='кофейни', city='almaty', limit=3)
📌 Шаг 3: save_note(filename='evening_plan', content='...')
🤖 Ответ: Погода 1.8°C — холодно. Нашёл 3 кофейни. План сохранён.
⚙️ Переменные окружения
| Переменная | Описание |
|---|---|
OPENAI_API_KEY |
Ключ OpenAI (для чата) |
USE_OLLAMA |
1 — использовать Ollama вместо OpenAI |
DGIS_API_KEY |
Ключ 2GIS API (если сайт блокирует) |
HEADED_BROWSER |
1 — открыть браузер видимо |
🔌 Подключение к Cursor
Settings → MCP → Add new MCP Server:
- Name:
WeatherAgent - Type:
command - Command:
python - Args:
weather_server.py - Cwd: путь к папке проекта
🛠 Режимы работы
| Режим | Команда |
|---|---|
| Чат с LLM | python chat_with_agent.py |
| Демо (без LLM) | python chat_with_agent.py --demo |
| MCP-сервер | python weather_server.py |
📊 Оценка проекта
Сильные стороны
- ✅ Два режима: MCP-сервер и интерактивный чат
- ✅ Отображение шагов LLM в реальном времени
- ✅ Fallback: 2GIS API при блокировке браузера
- ✅ Поддержка OpenAI и Ollama
- ✅ Демо-режим без API-ключей
Возможные улучшения
- Добавить unit-тесты для инструментов
- Вынести схемы инструментов в общий модуль (DRY)
- Добавить логирование
- Поддержка других городов в 2GIS
Соответствие ТЗ
| Критерий | Статус |
|---|---|
| get_weather через Open-Meteo | ✅ |
| save_note, list_notes, read_note | ✅ |
| Playwright / браузер для афиши | ✅ |
| Агент-планировщик (связка инструментов) | ✅ |
| Поиск в 2GIS | ✅ (API + браузер) |
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.