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 + браузер)