LPDP MCP Server
MCP Server untuk menjawab pertanyaan seputar pencairan keuangan beasiswa LPDP menggunakan RAG (Retrieval Augmented Generation) dengan Pinecone dan Gemini 2.0 Flash.
🚀 Fitur
- RAG-powered Q&A: Menjawab pertanyaan berdasarkan dokumen Panduan Pencairan Awardee LPDP
- Vector Search: Menggunakan Pinecone untuk pencarian semantik yang akurat
- Gemini 2.0 Flash: Response cepat dengan dukungan bahasa Indonesia yang baik
- MCP Protocol: Dapat diintegrasikan dengan Claude Desktop dan aplikasi AI lainnya
📋 Prerequisites
- Python 3.10+ (wajib untuk MCP SDK)
- Pinecone account (free tier)
- Google AI API key
🛠️ Instalasi
- Clone repository:
git clone <repository-url>
cd training-vibecode-mcp
- Install Python 3.11 (jika belum ada):
# macOS dengan Homebrew
brew install python@3.11
# Ubuntu/Debian
sudo apt update
sudo apt install python3.11 python3.11-venv
- Buat virtual environment:
python3.11 -m venv venv
source venv/bin/activate # Linux/macOS
# atau
.\venv\Scripts\activate # Windows
- Install dependencies:
pip install -r requirements.txt
- Setup environment variables:
cp .env.example .env
# Edit .env dengan API keys Anda
📚 Indexing Dokumen
Sebelum menggunakan server, index dokumen PDF ke Pinecone:
python -m scripts.index_documents
🖥️ Menjalankan Server
Sebagai MCP Server (untuk Claude Desktop)
Tambahkan konfigurasi berikut ke claude_desktop_config.json:
{
"mcpServers": {
"lpdp-pencairan": {
"command": "python",
"args": ["-m", "src.server"],
"cwd": "/path/to/training-vibecode-mcp",
"env": {
"PINECONE_API_KEY": "your_key",
"GOOGLE_API_KEY": "your_key"
}
}
}
}
Standalone Mode
python -m src.server
🔧 MCP Tools
| Tool | Deskripsi |
|---|---|
tanya_pencairan_lpdp | Menjawab pertanyaan umum tentang pencairan beasiswa |
cari_komponen_dana | Mencari informasi komponen dana spesifik |
cek_batas_waktu | Mengecek deadline pengajuan dana |
info_dana_bulanan | Informasi living allowance per negara/kota |
cari_dokumen_persyaratan | Dokumen yang dibutuhkan untuk pengajuan |
📊 Contoh Penggunaan
User: Berapa living allowance untuk mahasiswa di Jepang?
Bot: Living allowance untuk mahasiswa LPDP di Jepang adalah:
- Tokyo: JPY 195,000/bulan
- Kota lain: JPY 170,000/bulan
🧪 Testing
pytest tests/
📝 License
MIT License