# weather-mcp
Model Context Protocol (MCP) server untuk layanan cuaca.
## Instalasi
```bash
bun install
```
## Penggunaan
### Development
```bash
bun run dev
```
### Production
```bash
# Build project
bun run build
# Jalankan hasil build
bun run start
```
### Testing Fungsi Cuaca
```bash
bun run test_weather.ts
```
Contoh output:
```
Testing weather function...
Weather result: {
city: "Jakarta",
temperature: "6°C",
humidity: "74%",
windSpeed: "16m/s",
description: "snow",
weatherIcon: "01d",
pressure: "1048 hPa",
visibility: "2097m",
}
```
## Menjalankan Server dan Client MCP
### Menjalankan Server MCP
Untuk menjalankan server MCP secara langsung:
```bash
bun run src/index.ts
```
### Menjalankan Client untuk Testing
Untuk menjalankan client MCP (untuk testing koneksi):
```bash
bun run src/clients/weather.ts
```
Catatan: Pastikan server MCP sedang berjalan sebelum menjalankan client.
### Menjalankan Server untuk Pengujian (MCP Inspector)
Cara terbaik untuk memastikan server berjalan benar tanpa perlu client kustom adalah menggunakan MCP Inspector. Ini adalah alat debug resmi yang menyediakan antarmuka web.
```bash
npx @modelcontextprotocol/inspector node dist/server.js
#atau dengan bun
bunx @modelcontextprotocol/inspector bun src/index.ts
```
## Konfigurasi API
Untuk menggunakan API cuaca sebenarnya, set environment variable berikut:
```bash
export OPENWEATHER_API_KEY="your_api_key_here"
```
Jika environment variable ini tidak diset, maka sistem akan menggunakan simulasi data cuaca.
## Integrasi dengan Qwen CLI
Untuk mengintegrasikan MCP ini dengan Qwen CLI atau sistem lain yang mendukung MCP:
1. Pastikan MCP server dapat dijalankan sebagai executable
2. Konfigurasi client MCP untuk menjalankan perintah: `bun run dist/index.js` atau `node dist/index.js`
3. MCP akan berkomunikasi melalui STDIO sesuai spesifikasi Model Context Protocol
## Implementasi di Gemini CLI
Untuk mengimplementasikan server MCP ini di Gemini CLI, tambahkan konfigurasi berikut ke file konfigurasi MCP Anda:
```json
{
"theme": "GitHub",
"selectedAuthType": "oauth-personal",
"mcpServers": {
"weather": {
"command": "bun",
"args": ["run", "/home/balinux/Documents/code/AI-LLM-dev/mcp/weather-mcp/dist/index.js"], // absolute path
"env": {
"OPENWEATHER_API_KEY": "key"
}
}
}
}
```
Pastikan untuk:
1. Mengganti path `/home/balinux/Documents/code/AI-LLM-dev/mcp/weather-mcp/dist/index.js` dengan path absolut ke file hasil build Anda
2. Mengganti nilai `OPENWEATHER_API_KEY` dengan API key OpenWeather yang valid
3. Memastikan bahwa `bun` telah terinstal di sistem Anda
4. Menjalankan `bun run build` sebelum menggunakan server MCP untuk memastikan file `dist/index.js` tersedia
## Struktur Project
- `src/index.ts` - Server MCP utama
- `src/tools/weather.ts` - Definisi alat cuaca dan skema Zod
- `src/utils/weatherAPI.ts` - Logika pengambilan data cuaca dari API
- `src/clients/weather.ts` - Contoh client MCP untuk testing
- `dist/index.js` - Hasil build untuk deployment
