MCP API Tools

# MCP Server dengan Google AI Studio Server FastAPI yang menyediakan berbagai tools dan integrasi dengan Google Gemini AI. ## Fitur - **Auto Tool Router**: Routing otomatis ke tool yang tepat berdasarkan prompt - **Google Gemini Integration**: Integrasi dengan Google AI Studio (Gemini 2.0 Flash Exp) menggunakan LangChain - **Multiple Tools**: - Weather (Cuaca) - News (Berita) - Web Search (Pencarian Web) - Dictionary (Kamus) - Quotes (Kutipan Bijak) ## Persyaratan - Python 3.8+ - pip (Python package manager) ## Instalasi 1. Clone atau download repository ini 2. Install dependencies: ```bash pip install -r requirements.txt ``` Atau install manual: ```bash pip install fastapi uvicorn requests pydantic python-dotenv streamlit langchain-google-genai ``` 3. **PENTING**: Konfigurasi API Key Google a. Dapatkan API key dari [Google AI Studio](https://aistudio.google.com/app/apikey) b. Buat/edit file `.env` di root folder project: ``` GOOGLE_API_KEY=your_actual_api_key_here ``` c. Pastikan API key valid dan aktif (bukan expired atau restricted) **Catatan**: Ganti `your_actual_api_key_here` dengan API key Anda sendiri ## Menjalankan Aplikasi ### 1. Jalankan FastAPI Server Buka terminal pertama dan jalankan: ```bash uvicorn server:app --reload ``` Server akan berjalan di `http://localhost:8000` ### 2. Jalankan Streamlit App (Opsional) Buka terminal kedua dan jalankan: ```bash streamlit run app.py ``` Aplikasi Streamlit akan terbuka otomatis di browser (`http://localhost:8501`) ## Cara Penggunaan ### Menggunakan Streamlit UI (Recommended) Setelah menjalankan kedua server (FastAPI dan Streamlit), buka browser di `http://localhost:8501` **Fitur Streamlit App:** 1. **Auto Tool Router**: Masukkan pertanyaan dan sistem otomatis memilih tool yang tepat 2. **Google Gemini AI**: Chat interaktif dengan AI Google Gemini 3. **Manual Tools**: Pilih dan gunakan tool secara manual: - Weather Tool: Cek cuaca kota - News Tool: Cari berita berdasarkan topik - Dictionary Tool: Cari definisi kata - Quotes Tool: Dapatkan kutipan bijak - Web Search Tool: Pencarian web ### Menggunakan API (curl/Postman) #### 1. Auto Tool Router (`/auto`) Endpoint ini secara otomatis memilih tool yang tepat berdasarkan kata kunci dalam prompt. **Endpoint**: `POST /auto` **Request Body**: ```json { "prompt": "cuaca di Jakarta" } ``` **Contoh Penggunaan**: #### Cek Cuaca ```bash curl -X POST http://localhost:8000/auto \ -H "Content-Type: application/json" \ -d "{\"prompt\": \"cuaca di Bandung\"}" ``` #### Cari Berita ```bash curl -X POST http://localhost:8000/auto \ -H "Content-Type: application/json" \ -d "{\"prompt\": \"berita teknologi\"}" ``` #### Cari Definisi Kata ```bash curl -X POST http://localhost:8000/auto \ -H "Content-Type: application/json" \ -d "{\"prompt\": \"definisi technology\"}" ``` #### Dapatkan Quote ```bash curl -X POST http://localhost:8000/auto \ -H "Content-Type: application/json" \ -d "{\"prompt\": \"quote bijak\"}" ``` #### Web Search (Default) ```bash curl -X POST http://localhost:8000/auto \ -H "Content-Type: application/json" \ -d "{\"prompt\": \"python programming\"}" ``` #### 2. Google Gemini LLM (`/llm`) Endpoint untuk berkomunikasi langsung dengan Google Gemini AI. **Endpoint**: `POST /llm` **Request Body**: ```json { "prompt": "Jelaskan apa itu artificial intelligence" } ``` **Contoh Penggunaan**: ```bash curl -X POST http://localhost:8000/llm \ -H "Content-Type: application/json" \ -d "{\"prompt\": \"Apa itu FastAPI?\"}" ``` #### 3. Health Check (`/`) Cek status server. **Endpoint**: `GET /` ```bash curl http://localhost:8000/ ``` **Response**: ```json { "status": "MCP Server with Google AI Studio - OK" } ``` ## Dokumentasi API Interaktif Setelah server berjalan, akses dokumentasi API interaktif di: - Swagger UI: `http://localhost:8000/docs` - ReDoc: `http://localhost:8000/redoc` ## Struktur Proyek ``` . ├── .env # Environment variables (API keys) ├── server.py # Main FastAPI application ├── app.py # Streamlit frontend application ├── providers/ │ ├── google_llm.py # Google Gemini integration │ └── ollama_llm.py # Ollama integration (optional) └── tools/ ├── weather_tool.py # Weather API ├── news_tool.py # News API ├── search_tool.py # DuckDuckGo search ├── dictionary_tool.py # Dictionary API └── quotes_tool.py # Quotes API ``` ## Kata Kunci Auto Router Auto router mendeteksi kata kunci berikut: | Kata Kunci | Tool | Contoh | |------------|------|--------| | `cuaca`, `weather` | Weather Tool | "cuaca di Jakarta" | | `berita`, `news` | News Tool | "berita teknologi" | | `definisi`, `arti` | Dictionary Tool | "definisi python" | | `quote`, `bijak` | Quotes Tool | "quote bijak" | | Lainnya | Web Search | "python tutorial" | ## Screenshot Streamlit App Aplikasi Streamlit menyediakan 3 mode: 1. **Auto Tool Router** - Routing otomatis berdasarkan kata kunci 2. **Google Gemini AI** - Chat interface dengan history 3. **Manual Tools** - Pilih tool secara manual dengan UI yang user-friendly ## Troubleshooting ### Error: Module not found Pastikan semua dependencies sudah terinstall: ```bash pip install fastapi uvicorn requests pydantic python-dotenv streamlit langchain-google-genai ``` ### Streamlit tidak bisa connect ke server Pastikan FastAPI server sudah berjalan di `http://localhost:8000` sebelum menjalankan Streamlit ### Error: API key not valid / GOOGLE_API_KEY not found **Penyebab umum:** - API key tidak ada di file `.env` - API key expired atau tidak valid - API key memiliki restrictions yang tidak sesuai **Solusi:** 1. Pastikan file `.env` ada di root folder project 2. Dapatkan API key baru dari [Google AI Studio](https://aistudio.google.com/app/apikey) 3. Copy API key dan paste ke file `.env`: ``` GOOGLE_API_KEY=AIzaSy...your_actual_key ``` 4. Restart server FastAPI setelah mengubah `.env` 5. Pastikan tidak ada spasi atau karakter tambahan di API key ### Server tidak bisa diakses Pastikan server sudah berjalan dengan perintah: ```bash uvicorn server:app --reload ``` ### Request loading lama / timeout **Lihat panduan lengkap di [TROUBLESHOOTING.md](TROUBLESHOOTING.md)** **Quick Fix:** 1. Test components: ```bash python test_simple.py ``` 2. Try server without LLM: ```bash uvicorn server_simple:app --reload --port 8001 ``` 3. Check API key dan ganti jika perlu di file `.env` 4. Ganti model di `providers/google_llm.py`: ```python model="models/gemini-1.5-flash" # More stable ```