HEBAT Campus MCP

Read-only MCP server untuk menghubungkan Hermes Agent dengan HEBAT e-learning UNAIR berbasis Moodle.

Fitur

MCP ini menyediakan empat tool:

• hebat_status — mengecek apakah sesi login HEBAT masih aktif.

• hebat_dashboard — mengambil isi dashboard mahasiswa sebagai teks.

• hebat_courses — mengambil daftar mata kuliah dan tautannya.

• hebat_assignments — mengambil tautan tugas, resource, dan materi dari dashboard/course.

Server ini sengaja read-only. Tidak ada tool untuk mengumpulkan tugas, upload file, mengubah profil, menghapus data, atau mengirim pesan.

Related MCP server: mcp-moodle

Struktur

hebat_mcp/
├── login.py        # login lokal; password tidak disimpan
└── server.py       # MCP server stdio
requirements.txt

Persyaratan

• Python 3.11+

• requests

• MCP Python SDK 2.x

• Hermes Agent dengan dukungan native MCP

Install dependency aplikasi:

python3 -m pip install -r requirements.txt

SDK mcp biasanya sudah tersedia di virtual environment Hermes. Jika belum:

python3 -m pip install mcp

Login lokal

Jalankan di mesin yang menjalankan Hermes:

python3 hebat_mcp/login.py

Masukkan NIM dan password langsung di terminal. Password tidak dicetak dan tidak dimasukkan ke repository. Session cookie disimpan lokal di ~/.hermes/mcp/hebat/, yang tidak boleh di-commit.

Konfigurasi Hermes

Contoh konfigurasi melalui CLI:

hermes mcp add hebat \
  --command /path/to/hermes-venv/bin/python \
  --args /path/to/MCP-Kampus/hebat_mcp/server.py

Pilih untuk mengaktifkan semua tool yang ditemukan. Setelah menambah server, mulai sesi Hermes baru agar tool MCP tersedia.

Untuk mengecek koneksi:

hermes mcp list
hermes mcp test hebat

Keamanan

• Jangan commit cookies.env, cookies.txt, password, token, atau file .env.

• Jangan mengirim credential HEBAT melalui chat.

• Gunakan akun/session yang aksesnya sesuai kebutuhan.

• Implementasi ini hanya mengambil halaman yang bisa diakses oleh session login dan tidak melakukan operasi tulis.

Catatan

HEBAT dapat mengubah struktur HTML atau memperbarui mekanisme login/SSO. Jika tool tidak menemukan mata kuliah atau tugas, parser mungkin perlu disesuaikan dengan perubahan Moodle.

Lisensi

MIT