🌤️ Погодный MCP-сервер и интерфейс чат-бота для Cursor

Простой и полный проект на Python, который реализует Model Context Protocol (MCP) погодный сервер, готовый для Cursor IDE, в паре с веб-интерфейсом чат-бота для тестирования и общения с погодным агентом.

🌟 Возможности

• 🌐 MCP-сервер (weather_mcp_server.py): Создан с помощью FastMCP через stdio-транспорт. Предоставляет погодные инструменты для Cursor и других MCP-клиентов.

• ⚡ Бесплатная погода в реальном времени (weather_service.py): Работает на Open-Meteo. Не требуются API-ключи. Работает для любого города в мире.

• 🤖 Погодный агент (agent.py): Преобразует естественные запросы ("Погода в Токио", "5-дневный прогноз для Лондона", "Качество воздуха в Париже") в вызовы инструментов.

• 💻 Современный интерфейс чат-бота (static/ и app.py): Тёмная тема, стекломорфный веб-интерфейс с визуальными карточками погоды, таблицами прогнозов и значками выполнения инструментов.

• 🔌 Интеграция с Cursor (.cursor/mcp.json): Предварительно настроенный JSON для параметров Cursor.

Related MCP server: bridgemcp-server-weather

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

weather-mcp-chatbot/
│── .cursor/
│   └── mcp.json               # Cursor MCP configuration
│── weather_service.py         # Free Open-Meteo weather & geocoding integration
│── weather_mcp_server.py      # MCP Server (stdio transport for Cursor)
│── agent.py                   # Weather agent NLP & tool caller
│── app.py                     # FastAPI web server & chat endpoint
│── static/
│   ├── index.html             # Chatbot UI
│   ├── style.css              # Modern dark-mode styling
│   └── app.js                 # Chatbot frontend logic
│── test_mcp.py                # Automated test suite
│── requirements.txt           # Python dependencies
└── README.md                  # Documentation & quickstart

🚀 Быстрый старт

1. Установка зависимостей

pip install -r requirements.txt

2. Запуск веб-интерфейса чат-бота

python app.py

Откройте браузер и перейдите по адресу: http://127.0.0.1:8000

3. Запуск автоматических тестов

python test_mcp.py

🔌 Как подключиться к Cursor

Cursor может подключаться напрямую к вашему Python MCP-серверу для предоставления данных о погоде в реальном времени внутри Cursor Chat / Composer.

Вариант A: Использование .cursor/mcp.json (рекомендуется)

1. Откройте этот каталог проекта в Cursor:

   File -> Open Folder -> weather-mcp-chatbot

2. Файл .cursor/mcp.json внутри проекта автоматически обнаруживается Cursor.

Вариант B: Добавление в настройках Cursor

1. В Cursor откройте Настройки (Ctrl + , или Cmd + ,).

2. Перейдите в Возможности -> MCP-серверы.

3. Нажмите Добавить новый MCP-сервер:

   • Имя: weather

   • Тип: command (stdio)

   • Команда: python C:\Users\admin\.gemini\antigravity\scratch\weather-mcp-chatbot\weather_mcp_server.py

4. Нажмите Сохранить и проверьте зелёный индикатор состояния.

Использование в чате Cursor:

В Cursor Composer или Chat теперь можно спрашивать:

• "Какая сейчас погода в Токио?"

• "Проверь 5-дневный прогноз для Берлина с помощью @weather"

• "Какое качество воздуха в Париже?"

Cursor вызовет MCP-инструменты (get_current_weather, get_weather_forecast, get_air_quality) для получения живых данных!

🛠️ Предоставляемые MCP-инструменты