Skip to content
MuaraAIPublic

About

Unofficial REST API Aggregator for 6 UBSI University Services (SIAKAD, Elearning, E-Journal, E-Library, Repository, News)

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

8 stars

Watchers

1 watching

Forks

Repository files navigation

Mura, maskot Mira Mira

Satu pintu untuk semua layanan kampus UBSI.

Dashboard PWA, REST API, dan MCP Server untuk SIAKAD, MyBest, Ujian Online, Perpustakaan, Berita, dan Repository UBSI.

Website Release License Python Next.js Tests

Video · Fitur · Keamanan · Quickstart · MCP Server · Dokumentasi · Tim


Lihat Mira dalam 2 menit

mira-tutorial.mp4

Video tutorial 16:9 · 2:16 · narasi bahasa Indonesia + subtitle · data contoh fiktif (Dinda)

Daftar bab
Waktu Bab
0:00 Ribetnya portal kampus
0:12 Kenalan dengan Mira & masuk sekali
0:33 Ringkasan & jadwal
0:48 Kumpulkan tugas
1:00 Komunitas kelas
1:14 Rapi di semua layar
1:24 Notifikasi & presensi
1:40 Keamanan akun
1:50 Portal kampus vs Mira
2:04 Coba sekarang

Video dibuat dengan Remotion; sumber, naskah, dan cara render ada di promo-video/.

Kenapa Mira?

Layanan kuliah UBSI tersebar di enam portal berbeda dan sesinya habis setiap 15 menit. Mira menggabungkan semuanya dalam satu login, tetap aktif selama 7 hari, dan bisa dipasang di HP seperti aplikasi biasa.

Layanan Portal Yang tersedia di Mira
SIAKAD students.bsi.ac.id Profil, jadwal, nilai, KHS, KRS, kartu ujian
MyBest elearning.bsi.ac.id Mata kuliah, tugas, presensi, materi, kuis, forum
Ujian Online ujiankampusa.bsi.ac.id Jadwal dan kartu ujian (UTS, UAS, Her)
Perpustakaan elibrary.bsi.ac.id Cari buku dan skripsi, stok, lokasi rak
Berita news.bsi.ac.id Berita kampus resmi
Repository repository.bsi.ac.id Publikasi riset terbaru

Fitur

Untuk mahasiswa

  • PWA yang bisa dipasang di Android, iOS, dan desktop.
  • Notifikasi push: kelas segera mulai, presensi dibuka, deadline tugas.
  • Auto-relogin: tidak perlu login ulang tiap 15 menit.
  • Pratinjau dan unduh materi kuliah langsung di dashboard.
  • Komunitas: chat, spaces, dan profil antarmahasiswa.

Untuk developer

  • Personal API Key (muara_mira_*) untuk bot Discord, Telegram, atau skrip pribadi.
  • REST API dengan envelope JSON standar dan dokumentasi Swagger.
  • Cache Redis dua tingkat dengan fallback data terakhir saat kampus down.
  • MCP Server dengan 80 tools untuk AI agent.

Keamanan

Lapisan Perlindungan
Kredensial Password kampus dienkripsi AES-256-GCM, tidak pernah disimpan sebagai teks biasa
Login Maks 10 percobaan per menit per IP. Spam = IP diblokir otomatis 15 menit, naik ke 1 jam lalu 24 jam bila diulang
Brute force per akun Maks 5 percobaan per menit per NIM
Password default Akun yang masih memakai Mhs-1945 atau Mhs-2026 diingatkan di setiap halaman dan bisa langsung ganti password dari Mira
Aktivitas Jumlah login sukses dan gagal hari ini tampil di navbar desktop dan mobile
Lupa password Reset lewat NIM + email terdaftar. NIM dan email yang tidak cocok ditolak sebelum diteruskan ke kampus
Isolasi Sesi dan cookie kampus terpisah per NIM
Webhook Proteksi SSRF: blokir IP privat dan validasi DNS

Temukan celah keamanan? Laporkan sesuai SECURITY.md.

Quickstart

Mahasiswa: buka mira.muaraai.com, login dengan NIM serta password SIAKAD dan MyBest, lalu pasang sebagai aplikasi.

Developer:

git clone https://github.com/MuaraAI/Mira.git && cd Mira

# Backend (FastAPI, port 8300)
uv venv .venv --python 3.12 && source .venv/bin/activate
uv pip install -r requirements.txt
cp .env.example .env
uvicorn app.main:app --port 8300 --reload

# Frontend (Next.js, port 3000)
cd landing-page && npm install && npm run dev

Swagger UI: http://127.0.0.1:8300/docs

Testing (100% offline, tanpa request ke server kampus):

.venv/bin/pytest -q
cd landing-page && npm run build

MCP Server

Endpoint Streamable HTTP untuk AI agent:

claude mcp add --transport http mira-academic https://api.muaraai.com/v1/mira/mcp \
  --header "Authorization: Bearer muara_mira_YOUR_KEY"

Konfigurasi Cursor, Codex, dan Hermes ada di docs/mcp.md.

Dokumentasi

Dokumen Isi
docs/api.md Referensi endpoint REST API
docs/architecture.md Alur request, cache, dan session pool
docs/mcp.md Daftar tools MCP dan integrasi agent
docs/anti-ban.md Batas laju aman ke server kampus
docs/deploy.md Deploy ke VPS dengan PM2
CONTRIBUTING.md Alur branch, commit, dan pull request
promo-video/README.md Video tutorial Mira 2:16 (Remotion), narasi & SFX ElevenLabs, paket posting YouTube dan Instagram
PRIVACY.md · DMCA.md · Syarat Layanan Legal

Tim

Dikembangkan oleh Muara AI, mahasiswa Informatika UBSI Kampus Pontianak.

Nama Peran
Yuken Velino · @Curzyori Founder, Backend
Verzio Yamanansyah · @MyKineID Co-Founder, Frontend
M Raffli Aldiansyah · @Seeyaa77 Co-Founder, Hacker

Ingin ikut kontribusi? Baca CONTRIBUTING.md.

Disclaimer

Mira adalah proyek tidak resmi dan tidak berafiliasi dengan Universitas Bina Sarana Informatika. Semua merek dan data akademik adalah milik UBSI dan pemiliknya masing-masing. Risiko penggunaan ditanggung pengguna.

Pihak UBSI yang keberatan dengan proyek ini dapat menghubungi @Curzyori atau admin@muaraai.com. Repositori akan diarsipkan atau dihapus secara kooperatif.

Lisensi

MIT © Muara AI

About

Unofficial REST API Aggregator for 6 UBSI University Services (SIAKAD, Elearning, E-Journal, E-Library, Repository, News)

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

8 stars

Watchers

1 watching

Forks

Releases

Contributors

Languages