🌦️ 人工智能天气与情绪助手（由MCP提供技术支持）
这个项目， 模型上下文协议（MCP） 他是一个现代人工智能助理，使用他的架构开发。Google Gemini AI 模型与现实世界数据（天气、图像）相结合，并自主管理。
🏗️ 建筑 项目
通信流程（架构方案）
+-----------------+
| KULLANICI (UI) |
+--------+--------+
|
v
+-----------------+ +---------+---------+ +-----------------+
| GOOGLE GEMINI || (Node.js/Express) |----------->| (React + Vite) |
+-----------------+ Karar +---------+---------+ Yanıt +-----------------+
|
| (JSON-RPC via Stdio)
v
+---------+---------+
| MCP SERVER |
| (Python) |
+---------+---------+
|
| (HTTP Webhook)
v
+-----------------+ +---------+---------+
| EXTERNAL APIs || (Workflows) |
+-----------------+ +-------------------+
Bu Projede MCP Nasıl Kullanılıyor?
MCP Server (Python):
Konum: mcp-server/server.py
Görevi: Tool'ları tanımlar (get_weather, get_city_image, get_weather_forecast) ve n8n webhook'larına istek atar.
Teknoloji: Python SDK, httpx (Async HTTP Client).
MCP Client (Node.js):
Konum: backend/src/mcp-client.js
Görevi: Python sunucusunu stdio üzerinden çalıştırır ve yönetir. AI modelinin tool çağrılarını bu sunucuya iletir.
Teknoloji: Node.js, Child Process.
🚀 Kurulum ve Başlangıç
Gereksinimler
Node.js (v18+)
Python (v3.9+)
n8n (Lokal veya Cloud)
Adım Adım Kurulum
1. Projeyi Klonlayın
git clone
cd weather-app
2. Backend Kurulumu
cd backend
npm install
.env dosyasını oluşturun ve şu bilgileri ekleyin:
PORT=3001
GEMINI_API_KEY=your_gemini_api_key
N8N_WEBHOOK_BASE_URL=http://localhost:5678/webhook
3. Frontend Kurulumu
cd ../frontend
npm install
4. MCP Server Kurulumu
cd ../mcp-server
# Sanal ortam önerilir (Optional)
python -m venv venv
source venv/bin/activate # Windows: venv\Scripts\activate
pip install -r requirements.txt
5. n8n Workflow Kurulumu
n8n-workflows/ klasöründeki 3 adet .json dosyasını n8n arayüzünden Import edin.
n8n içinde OpenWeatherMap ve Unsplash API credential'larını tanımladığınızdan emin olun.
🎮 Uygulamayı Çalıştırma
Projeyi tam kapasite çalıştırmak için 3 ayrı terminalde şu komutları çalıştırın:
Terminal 1 (Backend):
cd backend
npm start
Terminal 2 (Frontend):
cd frontend
npm run dev
Terminal 3 (n8n):
n8n start
🔧 Teknik Detaylar: MCP Tool'ları
Tool Adı,Açıklama,Input Schema
get_weather,Şehir için anlık hava durumu bilgisini getirir.,"{ ""city"": ""string"" }"
get_city_image,Hava durumuna uygun atmosferik şehir görseli arar (Unsplash).,"{ ""search_query"": ""string"" }"
get_weather_forecast,Şehir için 5 günlük detaylı hava tahminini getirir.,"{ ""city"": ""string"" }"